Sphinx没有识别我的降价表

Question

我在本地使用sphinx和.md文件。当我以格式添加表格时：

|某事|别的东西更多的东西|

|一个|两个|三|

文本被解析为段落。 我已尝试使用rst文件，它以这种格式工作：

===== ===== ====

oneee ttttt ffff

===== ===== ====

sdddd dfvgd sdfv

dfgvv dffff ffff

===== ===== ====

当我使用第一个文件时，我收到有关错误结构化表格的错误消息，而在md文件中，它会保持沉默。

有什么想法吗？

Answer 1

搜索失败的方法是在标记时创建了Sphinx渲染表，I wrote an extension to do it.

可通过pip install sphinx-markdown-tables安装。

Answer 2

简而言之，标准Markdown不支持表格，也从不支持。您需要对表使用RST。

正如Sphinx documentation注意到：

  

为了支持基于Markdown的文档，Sphinx可以使用recommonmark。 recommonmark是Docutils与CommonMark-py的桥梁，CommonMark是用于解析spec Markdown风格的Python包。

事实上，对CommonMark rules的评论显示没有提及表格。就此而言，原始Markdown extensions也从未提及过表格。无论如何，多年来各种Markdown实现都以各种方式增加了对表的支持，其中一个更为人熟知的是GitHub。实际上，GitHub已经在CommonMark规范中发布了自己的Sphinx specific functionality，它增加了对表的支持。但是，Recommonmark / CommonMark-py不使用该规范，而是使用标准的CommonMark规范，因此没有表支持。

我查看了有关propmonmark和CommonMark-py的文档，但似乎也没有支持表作为选项。但是，propmonmark会添加一些{{3}}，默认情况下处于关闭状态。虽然它们主要与自动生成的目录和数学有关，但有enable_eval_rst选项，如果启用，则允许您在Markdown文档中直接嵌入RST。您可以在启用该功能的Markdown文档中包含RST表。