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 一个以上任意数量都合法,惯例写满与标题等长。

📚 相关条目

标题CommonMark 核心 分隔线CommonMark 核心
Web-Tutorial.com

Web-Tutorial 技术团队

由多位开发者共同维护的编程教程平台。每篇教程由对应领域的开发者编写和审核,确保内容准确可靠。如发现任何问题,欢迎向我们反馈。

100%

🙏 帮我们做得更好

我们是刚上线的编程教程站,几个人的小团队,精力有限。页面虽经检查,难免还有疏漏——链接失效、排版错乱、内容有误、语言生硬……

如果您发现了,麻烦告诉我们,我们会在收到反馈后第一时间进行修复,再次感谢您的光临 🙏