Markdown 标题空行调查笔记

Source Summary(来源总结)

这次调查同时看了 Markdown 语法标准侧和风格规范侧。

Extracted Facts(提取事实)

  • CommonMark / GFM 对 # 标题不要求必须和上下内容用空行隔开。
  • markdownlint 的 MD022 规则要求标题前后应有空行。
  • 因此,“标题后空一行”不是 Markdown 语法硬要求,而是常见风格规范。

Interpretation(解释)

  • 语法上可以不空行,但在长期写作、协作和 AI 编辑场景里,统一空行规则更稳。
  • Buu 明确不喜欢标题前后不空行,所以这里可以把它记成长期写作规则,而不只是可选风格。

Candidate Page Updates(候选页面更新)

Follow-up Questions(后续问题)

  • 是否还要把这一规则落到 markdownlint / formatter 配置里,形成自动执行。
  • 是否要把这个规则推广到 Buu 所有长期维护的 Markdown 仓库。