Discourse unterstützt jetzt native Markdown-Endpunkte, wodurch es für KI-Tools und andere Clients einfacher wird, Foreninhalt zu lesen, ohne vollständige HTML-Seiten zu parsen.
Diese Funktion wird standardmäßig auf allen gehosteten Sites über das System „Upcoming Changes“ aktiviert. Administratoren, die sich dagegen entscheiden möchten, können dies tun, indem sie die Site-Einstellung enable_markdown_endpoints deaktivieren.
Vielen Dank an @benword für die Erstellung des ursprünglichen Discourse to Markdown-Plugins, das die Vorläufer dieser Funktion im Discourse-Kern war.
Die Markdown-Ausgabe wird aus dem gerenderten („gekochten“) HTML der Beiträge generiert und bewahrt den Inhalt, den Leser sehen, einschließlich expandierter Links und verarbeiteter Formatierungen. Discourse-spezifische Elemente wie Zitate, Oneboxes, Codeblöcke, Umfragen und aufklappbare Abschnitte werden in Markdown zurückgewandelt. Themenantworten enthalten Metadaten und Paginierungslinks, und die konvertierten Beitragskörper werden mit einer Inhalts-Verdauung (Content Digest) zwischengespeichert, sodass Bearbeitungen eine neue Ausgabe erzeugen.
Clients können Markdown explizit über .md-URLs anfordern oder durch das Senden eines Accept: text/markdown-Headers. Die Verhandlung respektiert Qualitätswerte und wählt Markdown, wenn es HTML und JSON gegenüber bevorzugt wird; explizite .md-Anfragen behalten ihre Formate bei. Unterstützte HTML-Seiten bewerben ihr Markdown-Äquivalent über einen HTTP-Link-Header und ein <link rel="alternate">-Element.