woshale.com
← 返回博客

Markdown 十年:我的语法洁癖清单

用 Markdown 的第十年,我终于承认自己是"语法洁癖患者":看到别人用 <b> 加粗会坐立难安,列表前不空行会浑身难受。这份清单半是规范半是病历,供同病相怜者对照。

洁癖三条

曾经的误区

第一年是"语法收集者":表格、脚注、任务列表、数学公式,能用的都用。第五年幡然醒悟:语法的丰富度和文章的可读性经常成反比——脚注超过五个的文档,没有一条脚注会被读。现在我 90% 的文档只用七种语法:标题、段落、列表、引用、代码、行内代码、分隔线。

Markdown 的本意是"让写作退回纯文本",而滥用语法是把纯文本重新写成排版软件。

唯一的原则

十年总结下来其实只有一句:语法为节奏服务。段落是呼吸,列表是并列的鼓点,引用是降调的旁白。当你纠结"这里该用有序还是无序列表"时,真正的问题是"这几条到底有没有顺序"——语法问题,十有八九是思维问题。

← 更多文章 聊聊这篇 →