Обработка якорей в постах, созданных с помощью Markdown

Поддержка
2

Привет, добро пожаловать!

Этот синтаксис из kramdown или PHP Markdown Extra?

Discourse использует MarkdownIt, который основан на спецификации CommonMark. Он не поддерживает указание идентификатора заголовка.

Кажется, что этот вопрос обсуждался ранее: Anchors in markdown - Spec - CommonMark Discussion, но я не вижу какого-либо окончательного вывода.

Однако Discourse автоматически генерирует якоря.
Вы можете увидеть это здесь:

https://github.com/discourse/discourse/blob/main/app/assets/javascripts/discourse-markdown-it/src/features/anchor.js

В целом, вы можете ожидать следующие идентификаторы:

  • h-{headingId} (без ID поста, без слага)
  • h-{slug}-{headingId} (без ID поста)
  • p-{postId}-h-{headingId} (с ID поста, без слага)
  • p-{postId}-h-{slug}-{headingId} (с ID поста и слагом)

Например:

На изображении показан подробный интерфейс онлайн-IDE, демонстрирующий синтаксис HTML-кода с выделенными элементами, включая тег якоря, связанные с ним значения, CSS-свойство flex и семантически релевантные структуры кода. (Подпись сгенерирована ИИ)
На изображении показан подробный интерфейс онлайн-IDE, демонстрирующий синтаксис HTML-кода с выделенными элементами, включая тег якоря, связанные с ним значения, CSS-свойство flex и семантически релевантные структуры кода. (Подпись сгенерирована ИИ)865×308 23.1 KB

Если вы предпочитаете, вы все еще можете создать якорь вручную с помощью HTML, например, <a name="anchor_name"></a>

На изображении показано окно веб-браузера с открытым полем ввода «Заголовок», содержащим HTML-код: «<<» за которым следует '<a name="test">Header</a>'. (Подпись сгенерирована ИИ)
На изображении показано окно веб-браузера с открытым полем ввода «Заголовок», содержащим HTML-код: «<<» за которым следует '<a name="test">Header</a>'. (Подпись сгенерирована ИИ)708×156 6.87 KB

На изображении показан HTML-код, создающий тег якоря, привязанный к «header-1», с атрибутами «name» и «href», установленными в «p-704-a-nametestestast Header» и «test» соответственно, что указывает на интерфейс навигации по веб-странице, связанный с мониторингом производительности. (Подпись сгенерирована ИИ)
На изображении показан HTML-код, создающий тег якоря, привязанный к «header-1», с атрибутами «name» и «href», установленными в «p-704-a-nametestestast Header» и «test» соответственно, что указывает на интерфейс навигации по веб-странице, связанный с мониторингом производительности. (Подпись сгенерирована ИИ)801×190 16.3 KB

Дополнительные ресурсы —
Если вам нужно сгенерировать оглавление, для вас есть этот компонент: