狮身人面像不认识我的降价表



我在本地使用狮身人面像和.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 表。

最新更新