如何解决Markdown表格中行内代码包含|字符时无法正确渲染的问题

解决方法 #

主流Markdown渲染器（如GitHub Flavored Markdown、CommonMark）都支持两种方案来避免|被识别为表格列分隔符：

1. 反斜杠转义
   直接在要显示的|前加反斜杠\即可，修改后的表格代码如下：

| Operator | Description          |
|:---------|:---------------------|
| `&`      | bitwise and operator |
| `\|`     | bitwise or operator  |
| `^`      | bitwise xor operator |
| `<<`     | left shift operator  |
| `>>`     | right shift operator |

2. HTML实体编码替换
   如果遇到不支持反斜杠转义的老旧渲染环境，可以把|替换为对应的HTML实体|，效果和直接写|完全一致：

| Operator | Description          |
|:---------|:---------------------|
| `&`      | bitwise and operator |
| `|` | bitwise or operator  |
| `^`      | bitwise xor operator |
| `<<`     | left shift operator  |
| `>>`     | right shift operator |

两种方案渲染后，行内代码块里都会正常显示|字符，不会破坏表格结构。

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