在GitHub上,在.md
文件中,我能够指定在那里显示的标题级别,但我的.rst
文件不是:&# 34;最高"级别标题被视为1级标题,
例如,
## Heading
Stuff
## Sub-heading
More stuff
.md
中的会将第一个标题视为第二级标题,第二个标题视为第三级标题,而其等价物(例如由pandoc
生成),
Heading
-------
Stuff
Sub-heading
~~~~~~~~~~~
More stuff
被视为第一级和第二级标题。
有没有办法克服这个问题?我可以修复"在RST中的标题级别,就像GitHub解释它一样?
答案 0 :(得分:2)
不,这是不可能的。
Docutils不允许跳过标题级别。事实上,它会在不一致的嵌套级别上崩溃。此外,ReST语法中的字符代表哪个级别没有硬性规则。简单地假设它们按照它们被找到的顺序出现(当你退后一步然后再次向下时会出现不一致 - 假设你使用相同的模式返回)。因此,无论您使用哪个字符,第一个标头始终是1级标头(<h1>
)。但是,在Markdown中,语法中的级别是明确的。如果用户以### Header
开头,则文档中的第一个标头必须为3级(<h3>
)。在幕后,Docutils没有保留该信息的机制。它只知道标题是否是&#34;下一个更高的&#34;或&#34;降低&#34;等级连续。