Discourse prend désormais en charge les points d’accès Markdown natifs, facilitant ainsi la lecture du contenu des forums par les outils d’IA et d’autres clients, sans avoir à analyser des pages HTML complètes.
Cette fonctionnalité sera activée par défaut sur tous les sites hébergés via le système des modifications à venir. Les administrateurs qui souhaitent s’en exclure peuvent le faire en désactivant le paramètre de site enable_markdown_endpoints.
Merci beaucoup à @benword pour avoir créé le plugin Discourse to Markdown d’origine, qui a servi de précurseur à cette fonctionnalité dans le noyau de Discourse.
La sortie Markdown est générée à partir du HTML rendu (« cuit ») des messages, préservant le contenu vu par les lecteurs, y compris les liens développés et la mise en forme traitée. Les éléments spécifiques à Discourse, tels que les citations, les oneboxes, les blocs de code, les sondages et les sections repliables, sont convertis en Markdown. Les réponses aux sujets incluent des métadonnées et des liens de pagination, et les corps de messages convertis sont mis en cache à l’aide d’un digest de contenu afin que les modifications produisent une sortie fraîche.
Les clients peuvent demander explicitement le Markdown via des URL .md ou en envoyant un en-tête Accept: text/markdown. La négociation respecte les valeurs de qualité et sélectionne le Markdown lorsqu’il est préféré au HTML et au JSON ; les requêtes .md explicites conservent leurs formats. Les pages HTML prises en charge indiquent leur équivalent Markdown via un en-tête HTTP Link et un élément <link rel="alternate">.