Markdown表格内嵌代码块中竖线(|)的正确使用方法

核心结论 #

目前没有统一的Markdown规范强制要求（或禁止）转义表格内嵌代码块里的竖线，这属于不同渲染平台的实现差异问题。

两种写法的兼容性现状 #

• 直接使用|：Pandoc和Stack Overflow会将其识别为代码块内的语法符号，不会误判为表格列分隔符，渲染结果正常；但GitHub的GFM渲染引擎会优先解析表格的竖线规则，导致表格结构错乱。
• 使用转义写法\|：GitHub能正确识别这是代码内的竖线，避免表格结构破坏；但Pandoc和Stack Overflow会把转义符\当成代码的一部分显示出来，导致代码示例不符合预期。

规范层面的说明 #

CommonMark作为通用Markdown规范的基础，明确行内代码块中的内容属于“原始文本”，理论上不需要转义任何符号——包括竖线。但GitHub的GFM在表格场景下做了特殊逻辑处理：它会先扫描整个表格行的竖线来划分列，再处理行内的代码块，这就导致代码块里的竖线被提前当成了表格分隔符。这种差异不属于规范本身的矛盾，而是平台为了适配自身渲染逻辑做出的调整。

跨平台兼容的折中方案 #

如果需要兼顾多平台渲染效果，可以尝试以下两种方式：

• 使用全角竖线｜替代半角竖线|，大部分渲染引擎都会将其识别为普通字符，既不会破坏表格结构，也能在代码块里正常显示；但要注意这种写法是否符合代码的实际语义要求。
• 如果代码示例允许，用文字补充说明，比如写成按位或运算符 (|)，避免直接在代码块里写竖线。

内容的提问来源于stack exchange，提问作者user16549727