写部署记录时,给一行文字下面补上三条横线,本来想把下一段隔开,发布后上一行却变成了大标题。遇到这种变化,先看横线和前一段之间有没有空行,Markdown 会根据相邻结构解释同一组符号。

在Markdown转HTML工具输入下面两行,再接一行普通正文。本次生成的 HTML 中,“部署记录”被放进 h2,后面的文字另起一个 p 段落。

部署记录
---
下面是正文
当前工具把紧跟文本的横线解析成二级标题
当前工具把紧跟文本的横线解析成二级标题

这种写法属于 Setext 标题:文本在上,横线形式的下划线在下。它和使用井号的标题写法可以表达相同层级。此处横线参与了上一段的结构,最终没有额外生成一条分隔线。

第二次输入时,在“部署记录”和横线之间加入空行,并在横线后再空一行。当前工具生成的三个顶层元素依次是 p、hr、p。本机解析输出 HTML 后,也读到了同样的节点顺序,前一段文字继续作为普通段落保存。

真实两次输出及本机HTML顶层节点核对
真实两次输出及本机HTML顶层节点核对

如果希望明确写标题,可以直接使用 ## 部署记录;需要分隔线时,就让横线独立成块,前后各留空行。这种调整改变的是文本结构,读屏软件、目录生成与样式规则都可能根据不同标签作出不同处理,所以检查发布预览时别只看字号大小。

复制现成段落过来时,也要检查空行是否在粘贴中被压缩。有些编辑器会把连续空行合并,让原先独立的横线重新贴到正文下面。可以先查看转换后的 h2 与 hr 是否符合预期,再放进目标发布环境确认。关于正文、代码与HTML标签的基本关系,可以结合Markdown转HTML的检查方法一起阅读;列表和引用内部还应按各自上下文重新测试。