我可以修复"在GitHub上的rST标题级别?

时间:2015-11-22 15:04:56

标签: github markdown restructuredtext github-flavored-markdown

在GitHub上,在.md文件中,我能够指定在那里显示的标题级别,但我的.rst文件不是:&# 34;最高"级别标题被视为1级标题,

例如,

## Heading

Stuff

## Sub-heading

More stuff
.md中的

会将第一个标题视为第二级标题,第二个标题视为第三级标题,而其等价物(例如由pandoc生成),

Heading
-------

Stuff

Sub-heading
~~~~~~~~~~~

More stuff

被视为第一级和第二级标题。

有没有办法克服这个问题?我可以修复"在RST中的标题级别,就像GitHub解释它一样?

1 个答案:

答案 0 :(得分:2)

不,这是不可能的。

Docutils不允许跳过标题级别。事实上,它会在不一致的嵌套级别上崩溃。此外,ReST语法中的字符代表哪个级别没有硬性规则。简单地假设它们按照它们被找到的顺序出现(当你退后一步然后再次向下时会出现不一致 - 假设你使用相同的模式返回)。因此,无论您使用哪个字符,第一个标头始终是1级标头(<h1>)。但是,在Markdown中,语法中的级别是明确的。如果用户以### Header开头,则文档中的第一个标头必须为3级(<h3>)。在幕后,Docutils没有保留该信息的机制。它只知道标题是否是&#34;下一个更高的&#34;或&#34;降低&#34;等级连续。