Menü

Werkzeuge durchsuchenÄnderungsprotokoll

zum Navigieren zum ÖffnenBeschreiben Sie das Problem, nicht das Tool

Ratgeberantwort

Warum sich Markdown-Überschriftenlinks zwischen Websites unterscheiden

Die Markdown-Grammatik sagt, welcher Text eine Überschrift ist; Es standardisiert nicht die HTML-ID, die ein Host für diese Überschrift erfindet. Plattformen können Satzzeichen unterschiedlich entfernen, Unicode unterschiedlich behandeln und unterschiedliche Suffixe für Duplikate wählen. Wenn portable Links wichtig sind, fügen Sie explizite eindeutige IDs ein und verlinken Sie auf genau diese Werte. Überprüfen Sie dann, ob das Ziel rohe HTML-Anker zulässt.

Das Wichtigste
  1. Die Syntax der ATX- und Setext-Überschriften ist unabhängig von den generierten URL-Fragmenten eines Hosts standardisiert.

  2. Codezäune müssen erkannt werden, bevor Beispielzeilen mit Überschrift gescannt werden.

  3. Explizite IDs machen Rätselraten überflüssig, sind aber dennoch auf einen Renderer angewiesen, der erstellte Anker nicht bereinigt.

Die vollständige Erklärung

Eine Markdown-Überschrift ist eine tragbare Struktur. sein automatisches URL-Fragment ist es nicht. Hosts treffen unterschiedliche Entscheidungen in Bezug auf Interpunktion, Unicode, doppelte Suffixe und rohes HTML. Ein Inhaltsverzeichnis wird vorhersehbarer, wenn seine Ziel-IDs explizit sind und seine Annahmen im Dokument sichtbar sind. Lesen Sie den vollständigen Ratgeber für die Begründung, Beispiele und Definitionen hinter dieser Antwort.

Das Prinzip anwenden

Quellen