domain: markdown

第 01 节：Markdown 是什么，标题与段落

本节 objectives:

• 说清 Markdown 解决了什么问题、和"打字随便写"有什么不同。
• 能用 # 写出 1 到 6 级标题，并知道为什么 # 后面必须有空格。
• 能正确分段、正确换行，不再靠敲很多回车"蒙对"排版。

先修：无（只要求会打字、能打开浏览器） ｜ 上一节：无 ｜ 下一节 02 强调文字 >>

你写的字，为什么在别处长得不一样？

如果你在手机备忘录里写了"# 今天的待办"，保存后它还是原封不动的一行文字，# 号也老老实实地待在那里。但如果你把同样这行字粘贴到 GitHub、语雀、Notion 或者任何"支持 Markdown"的地方，它立刻会变成一个又大又粗的标题，# 号本身却消失了。

这不是巧合，也不是软件出 bug 了——你写的这行字用的是 Markdown 语法。Markdown 是一套约定：你打的每个符号（#、*、-……）本身不是普通文字，而是给"渲染器"（负责把文字变成排版效果的程序）看的指令。你写纯文本，渲染器读懂符号后，把它变成好看的标题、加粗字、列表——这就是这门课要教你的东西。

讲解

Markdown 是什么，为什么值得学：Markdown 由 John Gruber 在 2004 年设计，目标是让人不用鼠标点格式菜单，只靠打字就能写出排版清楚的文档¹。现在几乎所有技术文档、GitHub 项目说明（叫 README）、聊天软件的消息格式、笔记软件都在用它或它的变体。学会 Markdown 之后，你写的纯文本文件（后缀通常是 .md）可以被几乎所有平台正确显示，不需要为每个软件重新学一套排版方式。

练习环境提醒：这门课的每一节都建议你打开一个免费的在线 Markdown 编辑器（例如 https://dillinger.io/ ），左边打字、右边看实时预览。不需要安装任何软件，也不需要注册账号。本课接下来所有"跟我做一遍"和练习，都请你实际打开编辑器动手打一遍，而不是只用眼睛看。

标题（Heading）：在一行的开头写 1 到 6 个 # 号，# 号后面必须有一个空格，再跟标题文字，就是一级到六级标题²：

# 号的数量决定标题的级别——数量越多，级别越低、字号越小，就像书的目录里"第一章"比"第一章第一节"字更大一样。最常见的新手错误是漏掉 # 后面的空格，写成 #今天的待办：大多数渲染器不会把它当成标题，只会原样显示这行文字（包括 # 号本身）。

段落与空行：Markdown 里，普通文字直接写就是段落，不需要任何符号。用一个空行分隔两段文字，渲染后才会显示成两个独立段落；如果不留空行，两行紧挨着写，大多数渲染器会把它们合并成一段。

换行（不分段，只是另起一行）：如果你只是想在同一段里换一行显示（不想产生段落间距），需要在行尾多打两个以上的空格，再回车。这个规则不太直观，也不容易在编辑器里看出来——所以更推荐的做法是：能分段就用空行分段，真需要"只换行不分段"时再用这个技巧，或者直接用 <br>²。

跟我做一遍(worked example)

打开在线编辑器，跟着敲下面这段文字，观察右侧预览的变化：

观察要点：# 变成了大字标题、## 变成了小一点的标题；有空行的两段之间有明显间距；没有空行的两行被挤在了一起。这就是"空行 = 分段"的直接证据。

换你补全(faded example)

下面这段文字缺了两处标题符号和一处空行，请你把它补完整，让预览显示出"一个大标题 + 一个小标题 + 两个独立段落"的效果：

提示：一级标题的符号数量、二级标题的符号数量，以及哪里缺了一个空行。

答案：

（一级标题用一个 #，二级标题用两个 ##；"第一章"标题和下面那句话之间也需要空行，否则它们会挤在一起看着很乱。）

小结 + 通向下一节

这一节你学到了 Markdown 的基本原理（写符号给渲染器看）、标题语法（# 加空格加文字）、以及分段和换行的规则。这些是接下来所有语法的地基——下一节你会学怎么让某几个字"跳出来"变粗、变斜，这是笔记和文档里最常用的强调方式。