Markdown 标题空行调查笔记
Source Summary(来源总结)
这次调查同时看了 Markdown 语法标准侧和风格规范侧。
Extracted Facts(提取事实)
- CommonMark / GFM 对
#标题不要求必须和上下内容用空行隔开。 - markdownlint 的 MD022 规则要求标题前后应有空行。
- 因此,“标题后空一行”不是 Markdown 语法硬要求,而是常见风格规范。
Interpretation(解释)
- 语法上可以不空行,但在长期写作、协作和 AI 编辑场景里,统一空行规则更稳。
- Buu 明确不喜欢标题前后不空行,所以这里可以把它记成长期写作规则,而不只是可选风格。
Candidate Page Updates(候选页面更新)
- 已新增决策页:Buu 如何处理 Markdown 标题前后的空行
- 已与现有页面 Wiki 标题、文件名与标签的默认处理 建立关联
Related Pages(相关页面)
Follow-up Questions(后续问题)
- 是否还要把这一规则落到 markdownlint / formatter 配置里,形成自动执行。
- 是否要把这个规则推广到 Buu 所有长期维护的 Markdown 仓库。