章节摘要:基础语法解决"写得出",本章解决"表达得清"。表格承载多维对比,任务列表承载状态,脚注把长解释搬到页脚,Emoji 和上下标补齐最后一块表达拼图。这些都是 GFM 及各家方言贡献的扩展语法,也是"会不会 Markdown"的分水岭。
阅读完本章,你应当能够:
结构化记号的共同使命:把"需要读者费力组织的信息"提前组织好。
管道符与分隔行、三种对齐,以及单元格内塞列表的邪道与正道。
波浪线划掉旧信息,方括号勾选待办——两个高频小语法合讲。
方括号插数字,解释放文末,长文的清爽之道。
短码表情、上下标的方言差异,以及"少即是多"的使用纪律。
四节按"信息形态"分工,互不重叠:
对比型信息 ──→ 2.1 表格 状态型信息 ──→ 2.2 任务列表 解释型信息 ──→ 2.3 脚注 点缀型信息 ──→ 2.4 Emoji / 上下标
写文档前先问:这块信息是什么形态?形态对了,记号自然就选对了。
"信息形态定记号"这条主线值得再做一次实战推演,因为它比看上去难。拿一份典型的接口评审记录举例:接口参数五项、各自有类型与约束——这是对位比较,进表格;评审中达成的三项待办——状态型,进任务列表并写明责任人;某参数为何禁止负数的长解释——只对实现者重要,下脚注;破坏性变更的标注——点缀型信号,符号加文字并存。同一份记录里四种记号各就各位,读者扫表格知全貌、扫勾选知进度、需要细节时点脚注。反过来把这张地图用反——待办写成表格、参数塞进列表——每一步都在给读者制造整理负担。本章的练习建议:拿你上周写的任何一篇文档,逐块标注信息形态,再检查所用记号与形态是否匹配,错位的改写一遍。这一遍做下来,第 6 章的团队规范对你来说将不是约束而是常识的自然落地。
把四节记号串成一条流水线,比孤立记住四个语法更有用。写一篇新文档时的推荐节奏是:初稿阶段只用第 1 章的基础语法把内容倾倒出来,不急着上表格与脚注——过早排版是写作中断的最大来源;二稿时做"形态标注",把每块内容判定为对位型、状态型、点缀型或深注型;三稿才按形态落记号,此时每处表格、任务列表、脚注的引入都有明确理由,而不是"显得专业"的装饰。这个三稿节奏在团队推广时最容易见效,因为它把"规范"变成了流程的自然产物,评审时也不再需要争论"这里该不该用表格"——形态判据在前,记号选择只剩一种。
另一个值得提前知道的依赖关系:本章四节记号里,表格与任务列表是 GFM 扩展、脚注与上下标在 CommonMark 里根本没有标准定义,方言归属各不相同。也就是说,本章内容天然跨在第 4 章的方言地图之上——学记号的同时留意"它属于哪一方言",第 4 章到来时你会发现自己已经积累了素材。