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」下载（没用过苹果产品，没有发言权）。

What You See Is What You Mean

进阶

以上就是最基础的 Markdown 语法，普通用户看到这里就可以开始动笔尝试了。下面介绍一些 Markdown 的书写风格，让你的源码和文档更精美，更有条理。你不必一下子全部记住，需要实现哪个功能再来查阅或者问 Google 也不迟。

标题

层级

正文的标题从 ## 开始，# 留给文章的标题（也可以不写）。这样的大纲结构也可以很方便地转换为思维导图（Markdown to Xmind / MindNode / 幕布 / 百度脑图……）。
# 一级标题：文章的标题
## 二级标题：文章主要部分的大标题
### 三级标题：二级标题下面一级的小标题
### 四级标题：三级标题下面某一方面的小标题

虽然 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. 斜月沉沉藏海雾，碣石潇湘无限路。
2. 不知乘月几人归，落月摇情满江树。
3. 春江潮水连海平，海上明月共潮生。

预览

斜月沉沉藏海雾，碣石潇湘无限路。
不知乘月几人归，落月摇情满江树。
春江潮水连海平，海上明月共潮生。

对于比较短的、很少修改的有序列表，请按顺序标号，保持源码的可读性。

语法二（自动排序）

对于比较长的、可能会修改的列表（尤其是很长的嵌套列表），请使用「懒人编号法」。纵使有新的列表项「插队」，把序号弄乱了也没关系，Markdown 编辑器自动会对序号进行纠错。

1.  Foo.
1.  Bar.
    1. Foofoo.
    1. Barbar.
    1. Gargar
1.  Baz.

预览

Foo.
Bar.
1. Foofoo.
2. Barbar.
3. Gargar
Baz.

嵌套列表

缩进 2 ~ 4 个空格或一个 Tab（推荐），可以嵌套列表。

示例一

1.  不知乘月几人归，落月摇情满江树。
	- 与君吟弄风月，端不负平生。
	- 对秋深，离恨苦，数夜满庭风雨。
	- 五月畲田收火米，三更津吏报潮鸡。
2.  人姝丽，粉香吹下，夜寒风细。
	- 弓弦抱汉月，马足践胡尘。
	- 寒月悲笳，万里西风瀚海沙。
	- 东堂坐见山，云风相吹嘘。
3.  沅溪夏晚足凉风，春酒相携就竹丛。
	- 白发渔樵江渚上，惯看秋月春风。
	- 归来独卧逍遥夜，梦里相逢酩酊天。
	- 致君尧舜上，再使风俗淳。

预览

不知乘月几人归，落月摇情满江树。
- 与君吟弄风月，端不负平生。
- 对秋深，离恨苦，数夜满庭风雨。
- 五月畲田收火米，三更津吏报潮鸡。
人姝丽，粉香吹下，夜寒风细。
- 弓弦抱汉月，马足践胡尘。
- 寒月悲笳，万里西风瀚海沙。
- 东堂坐见山，云风相吹嘘。
沅溪夏晚足凉风，春酒相携就竹丛。
- 白发渔樵江渚上，惯看秋月春风。
- 归来独卧逍遥夜，梦里相逢酩酊天。
- 致君尧舜上，再使风俗淳。

示例二

- 庭说栏目
	> - 排版美学
	> - 数字生活    
	> - 日志随笔
- 联系方式
	> - Email：tingtalk.me(at)gmail.com
	> - Telegram：t.me/tingtalkgroup  
	> - WeChat：804 976 336

预览

庭说栏目
- 排版美学
- 数字生活
- 日志随笔
联系方式
- Email：tingtalk.me(at)gmail.com
- Telegram：t.me/tingtalkgroup
- WeChat：804 976 336

Tips

选中多个次级列表，Shift + Tab 可以批量删除缩进（消除嵌套）。

任务列表

语法

- [ ] 纯牛奶
- [x] 西瓜
- [ ] 鸡蛋
- [x] 保鲜膜
- [ ] 猪肉（暂时买不起）

预览

纯牛奶
西瓜
鸡蛋
保鲜膜
猪肉（暂时买不起）

引用

在每一行使用 > 符号，包括换行的句子。

> 我们是为人民服务的，所以，我们如果有缺点，就不怕别人批评指出。
> by 毛泽东：《为人民服务》（1944 年 9 月 8 日）

我们是为人民服务的，所以，我们如果有缺点，就不怕别人批评指出。
by 毛泽东：《为人民服务》（1944 年 9 月 8 日）

表格

语法

| 左对齐           |                      居中对齐                      | 右对齐 |
| :--------------- | :------------------------------------------------: | -----: |
| **加粗**         |          [插入链接](https://tingtalk.me/)          |  ￥5.7 |
| `换行`<br />下一行 | ![插入图片](https://tingtalk.me/uploads/avatar.png) | ￥10.4 |

预览

左对齐	居中对齐	右对齐
加粗	插入链接	￥5.7
`换行` 下一行		￥10.4

注释

Markdown 是轻量级的标记语言，所以不支持合并和拆分单元格。对于复杂表格，你可以在 Markdown 编辑器中使用 HTML 标签标记。
输入 <br /> 可以换行（但不建议使用）。
把 Excel 表格复制粘贴到某些 Markdown 编辑器（例如 Typora）可以直接转换为 Markdown 形式的表格。

链接

语法

[庭说](https://tingtalk.me/)

预览：庭说

图片

语法

![庭说 Avatar](https://tingtalk.me/uploads/avatar.png)

预览

Markdown 是一种纯文本标记语言，图片功能注定是它的弱项。

网络图床

但谁能保证哪个图床服务不倒闭？所以我在写作的时候，力求用文字把事情解释清楚，能不插入图片就不插入图片。我偶尔会用到的图床是 sm.ms（免费）。

本地图片

Typora 支持插入本地图片，但是更改图片的路径和名称，图片就失效了。如果文章已经完稿了，可以把 Markdown 导出为 PDF 文档（这样图片就嵌入进去了）。

代码

行内代码

用 2 个重音符 `（backtick，在 Tab 键上方）包裹

`Markdown` 是一种轻量级标记语言。

预览

Markdown 是一种轻量级标记语言。

重音符前后空一格

- 推荐：使用键盘快捷键 `Ctrl + D` 可以将当前网页保存为书签。
- 反对：使用键盘快捷键`Ctrl+D`可以将当前网页保存为书签。

预览

推荐：使用键盘快捷键 Ctrl + D 可以将当前网页保存为书签。
反对：使用键盘快捷键Ctrl+D可以将当前网页保存为书签。

代码块

将 3 个重音符 ` 置于代码块的首行和末行

print "Hello, Python!"

强制换行

在行末使用空格（两个以上） + 换行（Enter）。

`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 《乔布斯传》

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 《乔布斯传》

其他

名称	语法	备注
分割线	`---`、`***`、`+++`	不常用
内容目录	[TOC]	Table of Contents

应用

Markdown 的用途很广。Write once, export everywhere：写博客、写邮件、排推文、做 PPT 等。

公众号排版

可能吧公众号 Style 一键转换器：老司机禅叔出品。
WeChat Format：能把外部链接自动转为参考文献索引，并且附在文章末尾。

邮件排版

Markdown Here 是一个浏览器扩展插件，可以将浏览器中编辑器（例如 email 正文）里的 Markdown 文本转换成渲染过后的 HTML，并且支持自定义 CSS。详情移步在富文本在线编辑器中使用 Markdown。

转换为 Word

安装 Pandoc 后，Typora 可以导出 Word

转换为 Mind Map

对于 Xmind / MindNode / 百度脑图等思维导图工具，直接导入 md 文档。
对于幕布，可以用 Typora 导出 opml 格式，再导入。

参考

关联阅读

中文排版指南 - 庭说