如何从 Markdown 中的 headers 中删除锚链接？

Question

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

是否可以删除这个锚点？

Answer 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 页数

问题提到GitHub。假设这是指 GitHub 带有 Jekyll 的页面（因为那是 _config.yml 文件中的 only place GitHub makes use of Kramdown), you can set Kramdown options：

markdown: kramdown
auto_ids: false

请注意，如果您在 GitHub 页面上使用 GFM，或者如果您正在使用 GitHub 页面以外的任何其他 GitHub 服务，则此选项不可用，因为 GFM 不可用提供这样的选择。