Jekyll表格解析冲突：如何修复或禁用表格以兼容公式？

基于kramdown解析器的解决方案 #

1. 转义公式中的管道符 #

直接在行内公式的|前添加反斜杠，写成P(D\|θ)。kramdown会将转义后的管道符识别为普通字符，不会触发表格列边界的判断，适合公式出现频率不高的场景。

2. 完全禁用kramdown的表格解析功能 #

在Jekyll的_config.yml中添加以下配置，彻底关闭表格语法支持：

kramdown:
  disable_table_support: true
  # 保留其他原有配置，比如语法高亮、HTML解析等
  parse_block_html: true
  syntax_highlighter: rouge

配置生效后，所有管道符都会被当作普通文本处理，从根源上避免冲突。

3. 用明确标记包裹行内公式 #

利用kramdown对LaTeX的原生支持，用\(...\)或$$...$$包裹行内公式，确保解析器优先识别为数学公式而非普通Markdown内容。先在_config.yml中开启LaTeX引擎：

kramdown:
  math_engine: mathjax

之后直接写\(P(D|θ)\)或$$P(D|θ)$$，里面的管道符不会被误判。

基于CommonMark解析器的适配方案 #

如果偏好CommonMark，可通过配置开启行内LaTeX支持并优化转义规则：
在_config.yml中添加：

markdown: CommonMark
commonmark:
  options: ["SMART", "FOOTNOTES"]
  extensions: ["strikethrough", "autolink", "tagfilter", "math"]

开启math扩展后，CommonMark会识别$...$包裹的行内公式，无需额外转义反斜杠，同时保留基础的Markdown功能。

内容的提问来源于stack exchange，提问作者Evgeny P. Kurbatov