AI 输出的 Markdown 为什么样式错乱?逐条排查与处理
表格塌成竖线、公式变成乱码、代码块和正文粘在一起——按渲染链路逐层定位 AI 输出 Markdown 出错的原因。
AI 输出的 Markdown 样式错乱,多数不是内容写错,而是渲染环境不支持扩展语法——表格属 GFM 扩展、公式需额外数学渲染器、代码围栏前后要留空行。只想跨平台稳定,就只用最基础的语法。
先判断问题出在哪一层
遇到样式错乱,先分清是内容本身写错了,还是渲染环境不支持。这两类问题的修法完全不同:
- 内容写错:语法缺空行、缩进混乱、混用了不同风格的标记。
- 环境不支持:语法没写错,但当前渲染器不认这类扩展语法。
判断方法很简单:把同一段文本粘贴到一个已知支持完整语法的渲染器里。如果那边正常、这边不正常,就是环境问题;两边都错,就是内容问题。
常见故障与对应处理
表格塌成竖线
表格属于扩展语法,不少轻量渲染器默认关闭。处理方式有两种:换用支持扩展语法的解析器,或者干脆把表格改成嵌套列表——后者在任何环境下都不会出问题。
公式显示为纯文本
公式需要独立于 Markdown 的数学渲染器。只有 Markdown 解析器时,公式标记会被当作普通字符。确认渲染链路里有没有引入数学渲染组件,这是唯一的解决路径。
代码块粘连
围栏符号上下留空行是最省事的习惯。很多解析器对空行的容忍度不一致,空行能规避掉绝大部分边界情况。
列表层级错乱
嵌套列表对缩进宽度敏感。有的解析器要求两个空格,有的要求四个。混用制表符和空格基本一定会出问题——统一用空格,且同级对齐。
跨平台写作的稳妥做法
如果你希望同一份内容在多个平台都能正常显示,把语法收紧到最小集合:
- 标题只用
#到### - 列表统一用
- - 强调只用
**加粗** - 代码统一用围栏代码块并标注语言
- 需要表格时,考虑改成「字段名:值」的列表形式
这样写出来的内容不依赖任何扩展语法,兼容性最好。
常见问题
- AI 输出的表格为什么显示成一堆竖线?
- 多数情况不是表格本身写错了,而是渲染环境缺少表格扩展。标准 Markdown 语法里表格属于扩展语法(GFM),部分轻量渲染器默认不开启,于是把 | 当普通字符输出。把渲染器切换到支持 GFM 的解析器,或把表格改成列表,都能解决。
- 为什么 Markdown 里的数学公式显示不出来?
- 公式通常用的是 LaTeX 语法,需要额外的数学渲染器(如 KaTeX、MathJax)才能显示。只有 Markdown 解析器时,$...$ 和 \[...\] 会被当成普通文本。另外要确认公式与正文之间有没有被自动转义,转义后渲染器就识别不到了。
- 代码块和上一行正文粘在一起是什么原因?
- 常见于上下只写了一对 ``` 而中间没有空行。部分解析器要求围栏前后各留一个空行,否则会把它当作行内代码处理。补空行通常即可恢复。
- 同一段 Markdown 在不同平台显示不一样,正常吗?
- 正常。Markdown 本身没有唯一的标准实现,CommonMark、GFM 以及各家自研解析器对扩展语法、缩进、换行的处理都不同。想跨平台稳定,尽量只用最基础的语法:标题、列表、加粗、围栏代码块。