写Markdown教程时,外面用三个反引号包代码,里面又要展示一段同样的围栏。预览一生成,末尾就多出空代码块,或最后几行跑到了代码块外面。此时不是复制少了一行,而是围栏边界需要重新安排。

本文于2026年11月17日在Markdown转HTML中对照同长度反引号、外层四个反引号,以及外层波浪号,查看真实生成的HTML。

内外都用三个反引号时,会遇到提前结束

第一组尝试这样展示内部示例:

```markdown
```js
const x = 1;
```
```

本次HTML输出出现一个带markdown语言类的代码块,后面还有一个空代码块。中间那行不带其他内容的三个反引号,已经满足外层结束条件;最后那行又被解释成了新的开头。

内外同为三个反引号时,本次输出包含意外的空代码块,内部结束围栏提前终止了外层
内外同为三个反引号时,本次输出包含意外的空代码块,内部结束围栏提前终止了外层

注意,带js的那一行没有被直接当成关闭围栏,因为关闭行不能随意带上这种语言说明。真正冲突的是内部用于结束示例的裸围栏。理解是哪一行改变了解析状态,比在末尾继续补反引号更有效。

让外层更长,保留内部原样

第二组把外层改为四个反引号,内部仍然保留三个:

````markdown
```js
const x = 1;
```
````

本次只生成一个代码块,里面完整保留了内部的开头围栏、JavaScript文字和结束围栏。

外层四个反引号后,本次生成单一代码块,三个反引号的内部示例完整保留
外层四个反引号后,本次生成单一代码块,三个反引号的内部示例完整保留

围栏开头和结尾需要采用相同字符,结束长度至少达到开头长度。外层比需要展示的同类围栏更长,里面较短的行就不会把它关闭。

语言名只是帮助渲染器识别代码类别的说明,并不让这段代码自动执行。本例外层写markdown,是因为要展示Markdown源码;内部出现js,也仍然只是当前外层代码块中的文字。

换一种围栏字符也能避开冲突

第三组使用三个波浪号作为外层,内部继续使用三个反引号。本次HTML同样保留了完整内部示例。

~~~markdown
```js
const x = 1;
```
~~~
外层使用波浪号后,本次内部反引号仍作为普通代码内容保存,没有产生额外空块
外层使用波浪号后,本次内部反引号仍作为普通代码内容保存,没有产生额外空块

这给维护者留下两种清晰选择:让外层同类围栏更长,或让内外使用不同字符。应该选哪种,取决于发布平台支持的Markdown规则和文章中还需要展示什么内容,不必为了统一外观机械替换全部围栏。

如果示例本身包含更多反引号,外层长度还要相应调整。也要避免复制时把ASCII反引号换成外观接近的中文标点;字符不同,就不会形成预期的围栏。

发布前检查生成结构

预览不正常时,先看生成的HTML中有几个pre/code,而不只是观察颜色高亮。像本次第一组,额外的空代码块就是边界已经变化的证据;给它补CSS并不能修复解析结构。

将内容导出给另一平台后,也要重新看一次。不同编辑器支持的扩展和清洗流程可能不同,本次工具的正确输出不能代替目标平台的实际显示。若只想把尖括号或代码标签作为文字显示,还可配合HTML实体编码理解源码与可见文字的区别,但不要对整篇Markdown随意做多轮转义。

保留一份包含围栏行的最小样例,逐行核对开头字符、长度和关闭位置。确认内部示例能原样保留,再放回长文章,通常比反复拖动编辑器或增加空行更容易解决问题。