• [^] # Re: adoption

    Posté par (site web personnel, Mastodon) . En réponse au lien Les limites de Markdown (pour rédiger de la documentation) face aux capacités d’Asciidoc. Évalué à 3.

    Pas vérifié pour les autres, mais Github supporte aussi ReStruturedText : comparé à Asciidoc c'est tout aussi puissant mais moins compatible Markdown.

    Concernant les outils disponibles, le lien mentionne justement le fort couplage entre un site/plateforme et une appli, le format n'est pas portable/pérenne pour de la doc. Les reproches faits à Markdown peuvent se résumer dans l'absence de marquage/structuration évolué/complexe et beaucoup d’ambiguïté pour des choses quand même simples.

    "It is seldom that liberty of any kind is lost all at once." ― David Hume