Markdown 块与行内的优先级

最后更新:2026-10-14

块与行内的优先级 CommonMark 核心

Markdown 先解析块级结构(标题/列表/引用/代码块),再在块内解析行内元素。块级能打断一切:# 顶格出现就是标题,不管上下文是什么。

所属分组边界与规则
规范层级CommonMark 核心
规范版本CommonMark 0.31.2 + GFM

📝 语法

解析顺序:块级 → 行内

▶ 在线示例

在左侧编辑 Markdown,右侧实时看效果

💡 要点

ℹ️ 说明 这条优先级解释了很多现象:行内代码里的 # 不是标题、列表项里缩进的 # 是列表内标题。
💡 提示 排查「语法没生效」第一步:确认它没有被块级结构打断或吞掉。

❓ 常见问题

Q 列表项里能放标题吗?
A 能,缩进到内容层级后 # 是列表项内部的块级标题。
Q 行内代码能包含块级语法吗?
A 不能,行内代码内容完全字面化,# 就是井号。
Q 为什么引用里能放一切?
A 引用是块级容器,内部重新走一遍完整的块级解析流程。

📚 相关条目

行内代码CommonMark 核心 标题CommonMark 核心 列表嵌套CommonMark 核心
Web-Tutorial.com

Web-Tutorial 技术团队

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

100%

🙏 帮我们做得更好

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

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