Markdown 从降价采购时在Sphinx中创建表

我通过从降价源文件（即在我的

index.rst

文件中）中寻源来创建SphinX文档，我有：

.. toctree::
   :maxdepth: 2
   :caption: Contents:

   myMarkDownText
.
.
.

其中，

myMarkDownText

引用的是

myMarkDownText.md

我尝试使用以下两种格式从此源标记文件创建表：

| Name            | Age   |
| :---            |  ---: |
| John D Hunter   | 40    |

其中是MD语法中的，并且

==================   ============
Name                 Age
==================   ============
John D Hunter        40
==================   ============ 

其中是RST语法中的

当我通过以下方式创建SphinX输出

index.html

时，它们中没有一个会在我的SphinX输出中生成表格形状：

make html

你知道我应该尝试的其他格式/方式吗

请注意，如果我将表格放在SphinX中的

index.rst

中，我可以生成形状良好的表格。但这不是我的问题。我的问题是在SphinX中创建表，同时从

.md

源文件中获取资源

---

谢谢大家!

表语法是标记的非标准扩展，Sphinx使用的实现不支持该扩展。因此，这似乎是不可能的

根据，Sphinx使用解析Markdown文档，这是Markdown的一个实现。正如您在CommonMark规范中所看到的，表格不是受支持的功能。为了完整性，请注意，表格也不是原始表格的一部分。此外，对Recomonmark中的available的审查表明，没有对要启用的表的可选支持

---

也许存在一个带有docutils桥接器的替代标记实现，但我自己不知道有任何标记实现（推荐库在这里是离题的）。

表语法是标记的非标准扩展，Sphinx使用的实现不支持它。因此，这似乎是不可能的

根据，Sphinx使用解析Markdown文档，这是Markdown的一个实现。正如您在CommonMark规范中所看到的，表格不是受支持的功能。为了完整性，请注意，表格也不是原始表格的一部分。此外，对Recomonmark中的available的审查表明，没有对要启用的表的可选支持

也许有一个替代的Markdown实现与docutils桥接器一起存在，但我自己不知道有任何实现（推荐库在这里是离题的）。

当使用

recommonmark

从Markdown中获取资源时，该插件允许您在sphinx中获取表

另一种解决方案是将表放入csv文件中，并将csv文件转换为RST格式。如果您使用

recommonmark

从标记中获取源代码，您可以使用

eval\u rst

选项对rst代码段进行评估

解决方案2具有内置的优点，而解决方案1在设置后更容易，因为您不必处理额外的文件和绝对/相对路径问题

该插件允许您在使用

recomonmark

从标记中获取数据时，在sphinx中获取表

另一种解决方案是将表放入csv文件中，并将csv文件转换为RST格式。如果您使用

recommonmark

从标记中获取源代码，您可以使用

eval\u rst

选项对rst代码段进行评估

解决方案2具有内置的优点，而解决方案1在安装后更容易，因为您不必处理额外的文件和绝对/相对路径问题