Markdown代码示例里还有三个反引号,怎样避免代码块提前结束?
写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随意做多轮转义。
保留一份包含围栏行的最小样例,逐行核对开头字符、长度和关闭位置。确认内部示例能原样保留,再放回长文章,通常比反复拖动编辑器或增加空行更容易解决问题。