Markdown auf HTML
Was Markdown zu HTML bewirkt
Schreiben oder fügen Sie leichtes Markup ein – Überschriften, Listen, Links, Code-Zäune – und zeigen Sie eine Vorschau der HTML-Übersetzung an, die Ihre Laufzeit wahrscheinlich ausgibt. Die Geschmacksrichtungen sind unterschiedlich: GitHub fügt Tabellen und Durchstreichungen hinzu; CommonMark ist strenger in Bezug auf Einrückung und Absatztrennung. Rohe HTML-Blöcke in Markdown werden immer noch in vielen Pipelines durchlaufen – gehen Sie niemals davon aus, dass die Konvertierung vom Benutzer bereitgestellten Text bereinigt.
Wann man es verwenden sollte
Verwenden Sie es, wenn Sie README-Vorschauen erstellen, CMS-Renderfehler beheben oder überprüfen, ob verschachtelte Listen zusätzliche Einrückungen für Ihren Parser benötigen. Bereinigen Sie nach dem Rendern in HTML vor dem Speichern, ob Benutzer Markdown öffentlich übermitteln können. Kombinieren Sie konzeptionell mit HTML-Entitätskonverter für maskierte Snippets und HTML-Tags-Entferner, wenn Sie nur sichtbare Kopien benötigen.
Arbeitsbeispiel
Dokumente rendern Aufzählungslisten als Codeblöcke, da jede Zeile um vier Leerzeichen eingerückt wurde. Wenn man Markdown-to-HTML nebeneinander sieht, sieht man, dass die Spezifikation die Einrückung als abgegrenzten Codebereich behandelt – Autorenrichtlinien korrigieren, nicht die zufällige Laufzeitschätzung.
Häufig gestellte Fragen
Passt das zu meinem CMS?
Vielleicht teilweise. Validieren Sie immer anhand der genauen Markdown-Engine, die Ihre Plattform bündelt.
Bilder und HTTPS?
Markdown selbst schreibt unsichere Einbettungen nicht neu; Es gelten weiterhin CSP- und Mixed-Content-Richtlinien.
Warum wurden Überschriftenanker verschoben?
Slug-Algorithmen für Überschriften-IDs variieren je nach Renderer – codieren Sie Anker-URLs nicht systemübergreifend fest.