Markdown 入门教程及书写风格指南
现代汉语就像用脏了的人民币，要用 Markdown 洗一洗。Markdown 是一种轻量级标记语言。你不需要关心标题多大字号，段前距多少，列表缩进几格，只要在纯文本前后增加一些标记符号（例如 # - * >），就能毫不费力地写出工整精美的文章。毫不夸张地说，Markdown 是比特世界赠与写作者的「笔」。
请注意，Markdown 不要写成 MarkDown。
优势
掐指一算，使用 Markdown 写文章三年有余了。它的好，目前谁都比不了。
易学易记
只要几分钟就可以 学会 Markdown，然后你可能再也不想碰 Word 了。
专注写作
富文本编辑器（例如 Word）是通过点击图形化的功能按钮来实现排版，而 Markdown 则是通过标记字符去赋予文字不同格式。易读易写（easy-to-read and easy-to-write），让任何与文字打交道的人专注于写作，不用操心排版。
格式统一
同一份 Word 文档，在
- 不同的设备：Windows、macOS、Android、iOS
- 不同的版本：旧版 Word 、新版 Word
- 不同的软件：Microsoft Office、WPS
可能显示不一样的效果。而 Markdown 可以 Write once, export everywhere。不管在电脑上，还是手机上，用 Markdown 写出来的文章都能带来舒适、统一、美好的阅读体验。
向外兼容
可以导出 PDF、 Word、HTML、图片等格式分享给没有安装 Markdown 编辑器的人。
入门
一开始你只要记住以下符号（英文半角状态），就能写出排版清爽的文章了。
| 标记符号 | 标记结果 |
|---|---|
# + 空格 + 文本 |
一级标题 |
## + 空格 + 文本 |
二级标题 |
### + 空格 + 文本 |
三级标题 |
- + 空格 + 文本 |
无序列表 |
1 + . + 空格 + 文本 |
有序列表 |
> + 空格 + 文本 |
引用 |
如果有些文字需要特殊说明：
| 标记符号 | 标记结果 |
|---|---|
** + 加粗 + ** |
加粗 |
* + 斜体 + * |
斜体 |
~~ + 删除线 + ~~ |
是不是手痒了？下载一个 Markdown 编辑器， Keep calm and Markdown。目前我使用 有道云笔记 + Typora。
- Windows 用户推荐 Typora。
- Android 用户推荐 纯纯写作。
- 苹果用户（iOS 和 macOS）可以在 App Store 搜索「Markdown」下载（没用过苹果产品，没有发言权）。
进阶
以上就是最基础的 Markdown 语法，普通用户看到这里就可以开始动笔尝试了。下面介绍一些 Markdown 的书写风格，让你的源码和文档更精美，更有条理。你不必一下子全部记住，需要实现哪个功能再来查阅或者问 Google 也不迟。
标题
层级
-
正文的标题从
##开始，#要留给整篇文章的标题（也可以不写）。这样的大纲结构也可以很方便地转换为思维导图（Markdown to Xmind / MindNode / 幕布 / 百度脑图……），也符合 SEO（搜索引擎优化）的规则。# 一级标题（h1）：文章的标题
## 二级标题（h2）：正文的大标题
### 三级标题（h3）：正文的小标题 -
虽然 Markdown 最大支持
######六级标题，为了保持层级的简单，防止出现过于复杂的章节，请谨慎使用四级标题（除非是长文章）。如果三级标题下有并列性的内容，可以使用加粗、有序列表或无序列表代表末级标题。
短文章的标题层级
### 正文的小标题
**三级标题 A**
- 论据 1（五级标题）
- 细分论据 1（六级标题）
- 细分论据 2（六级标题）
- 细分论据 3（六级标题）
- 论据 2
- 论据 3
**三级标题 B**
1. 论据
2. 论据
3. 论据
**三级标题 C**
- 论据 1
- 论据 2
- 论据 3
---
长文章的标题层级
### 正文的小标题
#### 正文的三级标题 A
#### 正文的三级标题 B
#### 正文的三级标题 C -
二级标题下，不能直接出现四级标题。
-
标题要避免孤立编号（即同级标题只有一个）。
-
标题要简短，结尾不带标点符号。
-
（源码上）标题前后空一行（段前距和段后距）。
-
大标题和小标题之间要有内容过渡（引出或概括下文）。
# Title
开门见山地告诉读者这篇文章讲什么？
一级标题作为文章的（页面）标题（H1），并且尽可能和文件名称保持一致。
如果文章很长，使用 [TOC] 生成目录。
## What
先定义问题是什么？……
正文从二级标题开始。
## Why
为什么会出现这样的问题？……
## How
下一步该怎么办？……
## See also
文末别忘了贴上参考链接。
* https://link-to-more-info
列表
无序列表
使用 ‐ 或 * 或 + 并跟随 1 个空格来表示无序列表。建议使用 ‐（连字符，hyphen）。
- 我是谁 |
不建议
* 我是谁 |
为什么
- 星号
*可能和加粗和斜体符号产生混淆。 - 加号
+不流行。
与其他语法结合使用
- **《春日》**：等闲识得东风面，万紫千红总是春。 |
预览
- 《春日》：等闲识得东风面，万紫千红总是春。
- 《春草》：萋萋总是无情物，吹绿东风又一年。
- 《墨梅》：犹恨东风无意思，更吹烟雨暗黄昏。
有序列表
语法一（手动排序）
1. 斜月沉沉藏海雾，碣石潇湘无限路。 |
预览
- 斜月沉沉藏海雾，碣石潇湘无限路。
- 不知乘月几人归，落月摇情满江树。
- 春江潮水连海平，海上明月共潮生。
对于比较短的、很少修改的有序列表，请按顺序标号，保持源码的可读性。
语法二（自动排序）
对于比较长的、可能会修改的列表（尤其是很长的嵌套列表），请使用「懒人编号法」。纵使有新的列表项「插队」，把序号弄乱了也没关系，Markdown 编辑器自动会对序号进行纠错。
1. Foo. |
预览
- Foo.
- Bar.
- Foofoo.
- Barbar.
- Gargar
- Baz.
嵌套列表
缩进 2 ~ 4 个空格或一个 Tab（推荐），可以嵌套列表。
示例一
1. 不知乘月几人归，落月摇情满江树。 |
预览
- 不知乘月几人归，落月摇情满江树。
- 与君吟弄风月，端不负平生。
- 对秋深，离恨苦，数夜满庭风雨。
- 五月畲田收火米，三更津吏报潮鸡。
- 人姝丽，粉香吹下，夜寒风细。
- 弓弦抱汉月，马足践胡尘。
- 寒月悲笳，万里西风瀚海沙。
- 东堂坐见山，云风相吹嘘。
- 沅溪夏晚足凉风，春酒相携就竹丛。
- 白发渔樵江渚上，惯看秋月春风。
- 归来独卧逍遥夜，梦里相逢酩酊天。
- 致君尧舜上，再使风俗淳。
示例二
- 庭说栏目 |
预览
- 庭说栏目
- 排版美学
- 数字生活
- 日志随笔
- 联系方式
- Email：tingtalk.me(at)gmail.com
- Telegram：t.me/tingtalkgroup
- WeChat：804 976 336
Tips
Tab缩进一级Shift + Tab提升一级
任务列表
语法
- [ ] 纯牛奶 |
预览
- [ ] 纯牛奶
- [x] 西瓜
- [ ] 鸡蛋
- [x] 保鲜膜
- [ ] 猪肉（暂时买不起）
引用
在每一行使用 > 符号，包括换行的句子。
> 我们是为人民服务的，所以，我们如果有缺点，就不怕别人批评指出。 |
我们是为人民服务的，所以，我们如果有缺点，就不怕别人批评指出。
by 毛泽东：《为人民服务》（1944 年 9 月 8 日）
表格
语法
| 左对齐 | 居中对齐 | 右对齐 | |
预览
| 左对齐 | 居中对齐 | 右对齐 |
|---|---|---|
| 加粗 | 插入链接 | ￥5.7 |
换行下一行 |
 |
￥10.4 |
注释
- Markdown 是轻量级的标记语言，所以不支持合并和拆分单元格。对于复杂表格，你可以在 Markdown 编辑器中使用 HTML 的
<table>标签标记。 - 输入
<br />可以换行（但不建议使用）。 - 把 Excel 表格复制粘贴到某些 Markdown 编辑器（例如 Typora）可以直接转换为 Markdown 形式的表格。
链接
语法
[庭说](https://tingtalk.me/) |
预览：庭说
图片
语法
 |
预览
Markdown 是一种纯文本标记语言，图片功能注定是它的弱项。
网络图床
但谁能保证哪个图床服务不倒闭？所以我在写作的时候，力求用文字把事情解释清楚，能不插入图片就不插入图片。我偶尔会用到的 图床 是 sm.ms（免费）。
本地图片
Typora 支持插入本地图片，但是更改图片的路径和名称，图片就失效了。如果文章已经完稿了，可以把 Markdown 导出为 PDF 文档（这样图片就嵌入进去了）。
代码
行内代码
用 2 个重音符 `（backtick，在 Tab 键上方）包裹
`Markdown` 是一种轻量级标记语言。 |
预览
Markdown 是一种轻量级标记语言。
用两个 ` 包裹 `，才能显示 `：
A single backtick in a code span: `` ` `` |
预览
A single backtick in a code span: `
A backtick-delimited string in a code span: `foo`
重音符前后空一格
- 推荐：使用键盘快捷键 `Ctrl + D` 可以将当前网页保存为书签。 |
预览
- 推荐：使用键盘快捷键
Ctrl + D可以将当前网页保存为书签。 - 反对：使用键盘快捷键
Ctrl+D可以将当前网页保存为书签。
代码块
将 3 个重音符 ` 置于代码块的首行和末行。首行的重音符后面可接代码语言名称，例如 `````python``，以达到相应的代码高亮效果。
预览
print "Hello, Python!" |
- return 1 + 2
+ return num1 + num2
}
预览
function addTwoNumbers (num1, num2) { |
换行
以下键盘快捷键（语法）可能仅支持 Typora。
Enter = 换行 + 空行 = (Shift + Enter) × 2。
即按下回车键创建一个新段落（段与段之间加入空行）。
软换行
Shift + Enter = 换行（但是不会产生空行）。
`enticing` [ɪn'taɪsɪŋ] （事物）诱人的，有吸引力的；迷人的 |
enticing [ɪn'taɪsɪŋ] （事物）诱人的，有吸引力的；迷人的
-
Her neck was short but rounded and her arms plump and enticing.
她的脖子短，但浑圆可爱；两臂丰腴，也很动人。by 《飘》 -
This was enticing to Wozniak, even more than any prospect of getting rich.
这句话对沃兹尼亚克的诱惑太大了，比变成富人的诱惑还要大。by 《乔布斯传》
硬换行
在行末使用空格（两个以上） + 换行（Enter），就可以实现强制换行，此语法适用于大部分 Markdown 编辑器。
硬换行在文档被导出时将被保留，且没有换段的段后距。
假如生活欺骗了你， （2 个空格） |
假如生活欺骗了你，
不要悲伤，不要心急！
忧郁的日子里须要镇静：
相信吧，快乐的日子将会来临！
心儿永远向往着未来；
现在却常是忧郁。
一切都是瞬息，一切都将会过去；
而那过去了的，就会成为亲切的怀恋。
by 普希金
其他
| 名称 | 语法 | 备注 |
|---|---|---|
| 分割线 | ---、***、+++ |
不常用 |
| 内容目录 | [TOC] | Table of Contents |
应用
Markdown 的用途很广。Write once, export everywhere：写博客、写邮件、排推文、做 PPT 等。
公众号排版
- Markdown Nice：让微信排版变 Nice，支持自定义主题 CSS。
- 微信 Markdown 编辑器：高度简洁。
- 可能吧公众号 Style 一键转换器：老司机禅叔出品。
简历排版
邮件排版
Markdown Here 是一个浏览器扩展插件，可以将浏览器中编辑器（例如 email 正文）里的 Markdown 文本转换成渲染过后的 HTML，并且支持自定义 CSS。详情移步 在富文本在线编辑器中使用 Markdown。
转换为 Word
- 安装 Pandoc 后，Typora 可以导出 Word
转换为 Mind Map
- 对于 Xmind / MindNode / 百度脑图 等思维导图工具，直接导入 md 文档。
- 对于幕布，可以用 Typora 导出 opml 格式，再导入。
- Markmap：
Markdown + Mindmap，使用思维导图可视化 Markdown。
从网页导出 md 格式
借助浏览器插件 简约 导出 md 格式的网页，不用 手动添加标记符号。
导出漂亮的 Markdown 源代码图片
- 打开 carbon.now.sh
- 语言选择
Markdown - 书写或者粘贴 Markdown 源代码
- 导出 PNG 像素图或者 SVG 矢量图
参考
- Markdown 完全入门（上）
- Markdown 完全入门（下）
- Markdown Syntax - Daring Fireball
- 为知笔记 Markdown 新手指南
- Markdown 合集 - 少数派
- Google Markdown 书写风格指南
- Markdown Style Guide by Google
- Typora 完全使用详解 - liquid617
关联阅读