Как удалить якорные ссылки из заголовков в Markdown?

Question

В Github, когда вы создаете заголовок h2 или меньше (##, ###, ...), есть ссылка на ссылку, которая автоматически генерируется справа от заголовка. Когда вы щелкаете этот якорь, он связывает вас со страницей с таким заголовком в верхней части страницы (www.myurl # myheader).

Можно ли удалить этот якорь?

Answer 1

Вы можете отключить опцию Kramdown auto-ids . В зависимости от того, как вы используете Kramdown, есть несколько способов сделать это:

Командная строка

Если вы используете Kramdown из командной строки, просто включите --no-auto-idsопция:

kramdown --no-auto-ids

код Ruby

Если вы звоните Kramdown из своего собственного кода Ruby, установите auto_ids: false:

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

Изнутри документа

Вы также можете переопределить настройки по умолчанию в документе только для документа. Включите в документ следующую строку:

{::options auto_ids="false" /}

GitHub Pages

В вопросе упоминается GitHub. Предполагая, что это относится к GitHub Pages с Jekyll (так как это единственное место, в котором GitHub использует Kramdown ), вы можете установить параметры Kramdown в своем файле _config.yml:

markdown: kramdown
auto_ids: false

Обратите внимание, что если вы используете GFM на страницах GitHub или если вы используете какой-либо другой сервис GitHub, кроме GitHub Pages, эта опция недоступна, поскольку GFM не предлагает такую ​​возможность.