Gestione degli ancoraggi nei post creati con markdown

Arkshine · 28 Gennaio 2025, 3:58pm

Ciao, benvenuto!

Questa sintassi proviene da kramdown o PHP Markdown Extra?

Discourse si basa su MarkdownIt, che è basato sulla specifica CommonMark. Non supporta la specifica di un ID di intestazione.

Sembra che ne abbiano discusso a un certo punto: Anchors in markdown - Spec - CommonMark Discussion, ma non vedo alcuna conclusione definitiva.

Tuttavia, Discourse genera automaticamente l’ancora.
Puoi vederlo qui:

github.com/discourse/discourse

app/assets/javascripts/discourse-markdown-it/src/features/anchor.js

main

export function setup(helper) {
  if (helper.getOptions().previewing) {
    return;
  }

  helper.registerPlugin((md) => {
    md.core.ruler.push("anchor", (state) => {
      const postId = helper.getOptions().postId;

      for (
        let idx = 0, lvl = 0, headingId = 0;
        idx < state.tokens.length;
        idx++
      ) {
        if (
          state.tokens[idx].type === "blockquote_open" ||
          (state.tokens[idx].type === "bbcode_open" &&
            state.tokens[idx].tag === "aside")
        ) {
          ++lvl;

This file has been truncated. show original

Essenzialmente, puoi aspettarti questi ID:

h-{headingId} (nessun ID post, nessun slug)
h-{slug}-{headingId} (nessun ID post)
p-{postId}-h-{headingId} (ID post, nessun slug)
p-{postId}-h-{slug}-{headingId} (ID post, slug)

Ad esempio:

Se preferisci, puoi comunque creare un’ancora manualmente con HTML, ad esempio: <a name="anchor_name"></a>

Risorse aggiuntive –
Se hai bisogno di generare un Sommario, c’è questo componente per te:

Argomento		Risposte	Visualizzazioni
Markdown links to anchors not working? Support	7	5319	Giugno 25, 2024
Anchors Not Working Across Posts Within Topic Bug	11	549	Ottobre 1, 2022
Cannot deep link to anchor in text Support	6	1448	Dicembre 17, 2021
Auto Bookmarks plugin Plugin	9	2634	Marzo 5, 2019
Add Anchor ID to Text Support	5	1308	Agosto 23, 2021

Gestione degli ancoraggi nei post creati con markdown

Argomenti correlati