降级标题的python降价扩展
markdown-headdown的Python项目详细描述
向下:降级标题
自动降级那些讨厌的标题!
什么?
这是一个用于Python-Markdown的插件,可以按给定的级别自动降级标题。例如,当使用静态站点生成器(如Pelican)时,这非常有用。
为什么?
我不想写独立的标记文件,其结构是由我的网站的约束所决定的;我也不想因为我的标记文件而牺牲我的网站结构。已经存在许多3rd party Python-Markdown extensions来执行此操作(here和here),但我无法使它们与Python标记3一起使用。
怎么做?
只要把mdx_headdown
加到你的markdown
extensions
中,感受魔法。
您可以选择提供一个offset
参数,该参数告诉headdown
降级所有标题的级别。默认值是1
。
注意 :此值将转换为整数并被绝对化。未能提供数值选项可能会导致意外结果。
例如,如果与Pelican一起使用,您的configuration可能看起来像这样:
...MARKDOWN={'extensions':['mdx_headdown',],'extension_configs':{'mdx_headdown':{'offset':2,},},}...
学分
感谢mdx_downheader的作者,我检查了他的代码以获得灵感;感谢default python-markdown extensions的贡献者,我检查了他的代码以更好地了解manual在说什么。
本项目由Sascha Cowley在MIT License下于2018年版权所有。