如何在HAML的:markdown过滤器中渲染Markdown表格？

HAML的:markdown过滤器默认使用的Markdown解析器（比如Redcarpet）默认未启用表格渲染支持——表格属于GitHub Flavored Markdown（GFM）的扩展特性，并非标准Markdown的一部分，所以默认解析器不会处理表格语法。

解决步骤： #

• 配置解析器开启表格支持
  若使用Redcarpet，需手动开启表格扩展。在项目配置文件中添加如下配置：

  # Rails项目可在config/application.rb中添加
  Haml::Filters::Markdown.options = {
    renderer: Redcarpet::Render::HTML.new(tables: true),
    extensions: { tables: true }
  }
  

• 切换至默认支持表格的解析器
  也可以改用Kramdown解析器，它默认支持表格语法。先在Gemfile中添加gem 'kramdown'，再配置HAML使用该解析器：

  Haml::Filters::Markdown.use_haml_options = true
  Haml::Options.defaults[:markdown_engine] = :kramdown
  

• 检查缩进规范
  确保:markdown过滤器内的表格内容缩进统一，不要混合制表符与空格，避免解析器识别错误。

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