文本格式
标题、段落、换行、强调——这些看似最简单的语法,却是 Markdown 里最容易写错的部分。它们的共同点是:规则只有一两条,却高度依赖「空行在哪里」「符号紧挨着还是隔着空格」这类细节,一个不起眼的空格,就足以让整段文字的渲染结果面目全非。
常见错误是用空行分段时多敲了几个空格,或者用三个以上空格代替空行来换行,渲染出来却毫无变化。原因是 Markdown 的解析规则依赖缩进量与空行位置,这些细节不查文档很难靠猜。更根本的原因是解析器并不按「你看到的换行」理解文档,而是先把文件切成一行行,再依据空行、缩进和符号位置重新分组——你以为的排版,解析器看到的是另一回事。
因此这一章的重点不是背一张语法表,而是把「源码长什么样」和「渲染成什么样」摆在一起对照。每一种语法都会配上可以直接照抄的示例、对应的渲染结果,以及最容易踩中的那个坑——让你不是「知道有这回事」,而是当场就能把格式写对。
排版是文档质量的第一印象。这一章写好了,后面所有内容的呈现都会轻松很多:剩下的内容用的都是同一套「符号加空行」的思路,你不必为每个新语法重新建立心智模型,也能分辨哪些差异属于通用规范、哪些是某个平台的扩展,从而在换工具、换平台时不再莫名其妙地掉格式。
格式写对还有一层看不见的收益。结构清晰之后,自动生成的目录才不会是一团乱麻,搜索能找到真正相关的段落,屏幕阅读器也能按正确的顺序朗读。很多「读起来乱」的页面,根源并不在措辞,而在标题层级混乱、段落挤成一团——读者找不到入口,也无从判断哪一句才是结论。
这一章不要求你记住任何语法表,只要求你养成对照着源码和结果去理解的习惯。读完之后,你不仅能把格式写对,还能解释为什么必须这么写;这正是后面几章能够顺利展开的前提。
