Je suis d’accord, mais je tiens à noter que la plupart des forges de code supportent nativement Asciidoc, autant que le Markdown.
Ça ne présente donc quasiment aucun inconvénient de l’utiliser dans un dépôt hébergé sur des plateformes comme Github, Gitlab, Codeberg (ou n’importe quelle instance Gitea)...
Pour ce qui est du reste, les outils utilisant le Markdown (l’éditeur de LinuxFR!, discourse et autres) pour des trucs relativement basiques sont plutôt compatible avec Asciidoc (enfin... l’inverse!) qui fait de gros efforts pour ressembler à Markdown sur les trucs de base (équivalence entre les = et les # pour indiquer les niveaux de titre, gestion du markup de base similaire, etc).
J’ai l’impression que les subtilités entre Markdown et Asciidoc deviennent importantes sur des éléments plus complexes (images, blocs de code, tableaux) ou sur des cas où Markdown peut être ambigü (imbrications de styles).
Du coup, il me semble qu’apprendre le Asciidoc permet plus ou moins de se servir du Markdown quand même ! :-)
[^] # Re: adoption
Posté par Leirda . En réponse au lien Les limites de Markdown (pour rédiger de la documentation) face aux capacités d’Asciidoc. Évalué à 3.
Je suis d’accord, mais je tiens à noter que la plupart des forges de code supportent nativement Asciidoc, autant que le Markdown.
Ça ne présente donc quasiment aucun inconvénient de l’utiliser dans un dépôt hébergé sur des plateformes comme Github, Gitlab, Codeberg (ou n’importe quelle instance Gitea)...
Pour ce qui est du reste, les outils utilisant le Markdown (l’éditeur de LinuxFR!, discourse et autres) pour des trucs relativement basiques sont plutôt compatible avec Asciidoc (enfin... l’inverse!) qui fait de gros efforts pour ressembler à Markdown sur les trucs de base (équivalence entre les
=et les#pour indiquer les niveaux de titre, gestion du markup de base similaire, etc).J’ai l’impression que les subtilités entre Markdown et Asciidoc deviennent importantes sur des éléments plus complexes (images, blocs de code, tableaux) ou sur des cas où Markdown peut être ambigü (imbrications de styles).
Du coup, il me semble qu’apprendre le Asciidoc permet plus ou moins de se servir du Markdown quand même ! :-)