我在本地使用狮身人面像和.md文件。当我添加以下格式的表格时:
|某物 | 别的 | 更多 |
|一 | 二 | 三 |
文本被解析为一个段落。 我尝试过使用 rst 文件,它以这种格式工作:
===== =========
oneee ttttt ffff
===== =========
SDDDD DFVGD SDFV
DFGVV DFFFF FFFF
===== =========
当我使用 rst 文件时,我收到有关结构错误的表的错误消息,而在 md 文件中它会静音。
有什么想法吗?
在寻找在markdown 中创作 Sphinx 渲染表的方法失败后,我写了一个扩展来做到这一点。
它可以通过pip install sphinx-markdown-tables
安装。
简而言之,标准的 Markdown 不支持表格,也从来没有。您需要对表使用 RST。
正如狮身人面像文档所指出的:
为了支持基于 Markdown 的文档,Sphinx 可以使用 recommonmark。 recommonmark 是 Docutils 通往 CommonMark-py 的桥梁,CommonMark-py 是一个用于解析 CommonMark Markdown 风格的 Python 包。
事实上,对CommonMark规范的审查显示没有提到表格。就此而言,最初的降价规则也从未提及表格。无论如何,多年来,各种 Markdown 实现以各种方式添加了对表的支持,其中最著名的是 GitHub。事实上,GitHub已经发布了自己的CommonMark规范扩展,增加了对表的支持。但是,recommonmark/CommonMark-py 不使用该规范,而是使用标准的 CommonMark 规范,因此没有表支持。
我检查了recommonmark和CommonMark-py的文档,但似乎都不支持表格作为选项。但是,recommonmark确实添加了一些Sphinx特定的功能,默认情况下是关闭的。虽然它们主要与自动生成的目录和数学有关,但有一个enable_eval_rst
选项,如果启用,允许您直接在 Markdown 文档中嵌入 RST。您可以在启用了该功能的 Markdown 文档中直接包含 RST 表。