用 Markdown 的第十年,我终于承认自己是"语法洁癖患者":看到别人用 <b> 加粗会坐立难安,列表前不空行会浑身难受。这份清单半是规范半是病历,供同病相怜者对照。
洁癖三条
- 标题最多两级——文章不是目录树,h3 以下说明结构失控。本站所有文章都只有 h2;
- 强调只用斜体与 code——加粗是视觉暴力,
行内代码才是"这个名词有生命"的正确表达; - 列表前后必须空行,嵌套不超过两层——三层嵌套的列表是"我不想组织语言"的自白书。
曾经的误区
第一年是"语法收集者":表格、脚注、任务列表、数学公式,能用的都用。第五年幡然醒悟:语法的丰富度和文章的可读性经常成反比——脚注超过五个的文档,没有一条脚注会被读。现在我 90% 的文档只用七种语法:标题、段落、列表、引用、代码、行内代码、分隔线。
Markdown 的本意是"让写作退回纯文本",而滥用语法是把纯文本重新写成排版软件。
唯一的原则
十年总结下来其实只有一句:语法为节奏服务。段落是呼吸,列表是并列的鼓点,引用是降调的旁白。当你纠结"这里该用有序还是无序列表"时,真正的问题是"这几条到底有没有顺序"——语法问题,十有八九是思维问题。