2017-08-05 283 views
2

我有一个* .md文件,我将在Sphinx的帮助下将其放入文档中。这些文件包含表格。如何使用Sphinx从包含表格的markdown呈现HTML使用Sphinx

文档说执行以下操作:

  • PIP安装recommonmark
  • 添加:

    source_parsers = { '.MD': 'recommonmark.parser.CommonMarkParser', }

    source_suffix = ['.rst','.md']

to conf.py

因此,表格不能正常渲染。其余的md语法呈现正常。

回答

1

它看起来像recommonmark不支持表,如issue #3PR #68中所述。

+0

它真的很奇怪:) –

+0

@ArtemZhukov不,只是不支持。 :)有人试图在该公关中纠正该问题。也许您可以为开源软件项目提供补救措施,或者在您安装recommonmark的过程中修改PR源,以使其运行。 –

+1

是的。表格是非标准功能。任何支持它们的Markdown实现都是作为附加组件实现的。由于它们是非标准的,所以每个实现都为它们实现了稍微不同的语法。纯Markdown实现不支持表格。 – Waylan