Sphinx没有识别我的降价表

Question

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

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

| 一个| 两个| 三个|

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

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

oneee ttttt ffff

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

sdddd dfvgd sdfv

dfgvv dffff ffff

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

当我使用第一个文件时,我收到有关错误结构表的错误消息,而在md文件中,它会变为静音.

有任何想法吗？

Answer 1

在没有成功搜索在markdown中创建Sphinx渲染表的方法之后,我编写了一个扩展来执行此操作.

它可以通过安装pip install sphinx-markdown-tables.

Answer 2

简而言之，标准 Markdown 不支持表格，而且从来没有。您将需要对表使用 RST。

正如Sphinx 文档所指出的：

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

事实上，对 CommonMark规范的审查表明没有提到表格。就此而言，原始的 Markdown规则也从未提及表格。无论如何，多年来，各种 Markdown 实现都以各种方式增加了对表格的支持，其中最著名的一种是 GitHub。事实上，GitHub 已经发布了他们自己的 CommonMark 规范扩展，增加了对表的支持。但是，recommonmark/CommonMark-py 不使用那个规范，而是使用标准的 CommonMark 规范，所以没有表格支持。

我检查了 recommonmark 和 CommonMark-py 的文档，但似乎都不支持表格作为选项。然而，recommonmark 确实添加了一些Sphinx 特定的功能，默认情况下是关闭的。虽然它们主要与自动生成的目录和数学有关，但有一个enable_eval_rst选项，如果启用，则允许您将 RST 直接嵌入到 Markdown 文档中。您可以在启用该功能的 Markdown 文档中直接包含 RST 表。