关于 Markdown 标题前后空行规则的对话摘录

  • Date: 2026-04-12
  • Participants: Buu, Hermes

User concern

Buu 发现有些 Markdown 文档里标题下面没有保留空行,例如 SOUL.md,这会带来明显的不适感。Buu 需要一个明确标准:标题和正文之间是否应该留空行,以及这个规则属于语法标准、风格规范,还是个人规则。

Final choice from this discussion

  • 从 Markdown 语法标准看,标题下面不强制要求空一行。
  • 从常见文档风格规范看,标题前后保留空行是更常见的推荐写法。
  • Buu 明确决定:以后自己的 Markdown 默认把标题前后都留一个空行。
  • 这个规则需要被当作长期稳定偏好保存,并在 llm-wiki 中记录。