Markdown Setext 标题
最后更新:2026-10-14
Setext 标题 CommonMark 核心
老式标题写法:文字下一行用 = 是一级标题、用 - 是二级标题,与 # 号式(ATX)渲染结果相同。了解它是为了读懂老文档,更重要的是避开 --- 误触发标题的坑。
| 所属分组 | 边界与规则 |
|---|---|
| 规范层级 | CommonMark 核心 |
| 规范版本 | CommonMark 0.31.2 + GFM |
📝 语法
标题文字
======
标题文字
------
▶ 在线示例
在左侧编辑 Markdown,右侧实时看效果
💡 要点
⚠️ 注意 最常见的坑:段落下一行手滑写了 ---,段落瞬间变二级标题——分隔线前务必空行。
💡 提示 新文档一律用 ATX(#)式标题,Setext 只作知识储备。
❓ 常见问题
Q 为什么叫 Setext?
A 源自 1990 年代的 Setext(Structure Enhanced Text)格式,Markdown 继承了它。
Q 有三级以上吗?
A 没有,Setext 只有一、二两级;三级以上只能用 # 式。
Q = 或 - 的数量有要求吗?
A 一个以上任意数量都合法,惯例写满与标题等长。