Markdown

很早之前就在豆瓣上被阳志平老师推广学习过 Markdown，有过学习。这次终于又将这个知识给用上了！

什么是 Markdown？

markdown 是一种标记语言。其思路是用写作中很难用到的符号，作为段落或文字的结构和格式标记，让作者不必纠结于格式，好专心于写作。

为什么要用 Markdown？

• 作者可以不必纠结于格式问题，专心与写作
• 帮助梳理文章的逻辑和结构
• 减轻文档容量
• 方便修改

Markdown 的问题

• markdown 的出发点是为了尽量减少对写作的干扰，但是 markdown 是基于英文符号的，所以中文写作中会出现「切换延迟」的问题。
• markdown 中承担标记作用的符号尽管不常用，但是偶尔也需要在正文中用到，会出现歧义问题。目前的解决措施是在要写的符号前加一个 /，如 /#

Markdown 语法

标题

Markdown 中有两种表达标题的方式

• 在文字的前面加 #，Markdown 最大支持 6 级标题，分别用 1 到 6 个 "#"来表示，如：
  • # 一级标题
  • ## 二级标题
• 在文字的下一行加上底线，可以定义 2 级标题：
  • 在文字下一行加上任意数量的 =，表示该行文字为 1 级标题
  • 在文字下一行加上任意数量的 -，表示该行文字为 2 级标题

段落和换行

一个 Markdown 段落是由一个或多个连续的文本行组成，它的前后要有一个以上的空行（空行的定义是显示上看起来像是空的，便会被视为空行。比方说，若某一行只包含空格和制表符，则该行也会被视为空行）。普通段落不该用空格或制表符来缩进。

两种换行的方式：

• 通过插入 <br /> 来换行。
• 在一个段落的末尾连续输入 3 个空格，可以实现换行

列表

• 无序列表
  无序列表使用星号*、加号+或是减号-作为列表标记，且符号和文字之间要加 1 个空格：
  * 列表1
* 列表2

• 有序列表 无序列表使用数字+空格+点作为列表标记，且有序列表会自动排序，数字为多少不影响排序：

引用

在引文前面加上 > 符号可以实现引用，如：

在引文前面加上 > 符号可以实现引用

强调

• 斜体 *粗体*，* 可以用-替换
• 粗体 **粗体**，* 可以用-替换
• 粗体加斜体 ***粗体加斜体***，* 可以用-替换

  代码

内页导航

参见 《MarkDown技巧：两种方式实现页内跳转》

Markdown 编辑器

待增补

参考

• Markdown 官方手册（中文）
• 阳志平老师制作的在线版 markdown 编辑器
• Markdown+Pandoc: 轻量级科学论文写作方案