如何从Markdown中的标题中删除锚链接?

时间:2019-11-10 01:36:46

标签: html markdown kramdown

在Github中,当您创建h2或更小的标头(##,###,...)时,标头右侧会自动生成一个锚链接。当您单击此锚点时,它将链接到页面顶部具有该页眉的页面(www.myurl#myheader)。

是否可以删除此锚点?

1 个答案:

答案 0 :(得分:1)

您可以禁用Kramdown的auto-ids选项。根据您使用Kramdown的方式,有多种方法可以使用:

命令行

如果您是从命令行使用Kramdown,只需添加--no-auto-ids选项:

kramdown --no-auto-ids

Ruby代码

如果要使用自己的Ruby代码调用Kramdown,请设置auto_ids: false

Kramdown::Document.new(source_text, {auto_ids: false})

来自文档内部

您还可以仅在文档中覆盖文档中的默认设置。单独一行包含以下内容:

{::options auto_ids="false" /}

GitHub Pages

该问题提到了GitHub。假设这是指使用Jekyll的GitHub Pages(即only place GitHub makes use of Kramdown),则可以在_config.yml文件中set Kramdown options

markdown: kramdown
auto_ids: false

请注意,如果您在GitHub Pages上使用GFM或使用除GitHub Pages之外的其他GitHub服务,则此选项不可用,因为GFM不提供此选项。