# Convertisseur Markdown ⇄ AsciiDoc Convertissez dans les deux sens entre Markdown (saveur GitHub) et AsciiDoc (le format standard d'Antora, Red Hat et Asciidoctor) : décalage automatique des niveaux de titres (= est le titre du document en AD), inversion de l'ordre des crochets des liens, blocs de code ⇄ [source], tables GFM ⇄ |===, admonitions NOTE/TIP/WARNING, listes de tâches, notes de bas de page, ancres et renvois, sauts de ligne durs ; les constructions sans équivalent parfait sont listées en avertissements. > Page canonique: https://elysiatools.com/fr/tools/markdown-asciidoc-converter - **Catégorie:** Format Conversion - **Mots-clés:** markdown vers asciidoc, asciidoc vers markdown, migration antora, convertir asciidoctor, convertisseur documentation ## Présentation Le convertisseur est un analyseur de blocs ligne à ligne doublé d'un tokenizer d'emphases en ligne, sans dépendance, dans les deux sens. Règles clés : MD #/## → AD ==/=== (sauf promotion du premier H1 en titre =) ; \[texte\](url) devient url\[texte\], les URL avec parenthèses ou tirets bas sont enveloppées dans ++…++ ; les clôtures \`\`\` → \[source,lang\] + ---- ; les tables GFM → |=== avec options="header" et l'alignement :--- dans le colspec ; les citations > → bloc \[quote\] avec \[quote, auteur\] ; NOTE:/TIP:/IMPORTANT:/WARNING:/CAUTION: ⇄ alerte GitHub > \[!NOTE\] ; listes de tâches, notes de bas de page, \[\[ancres\]\], <\>, sauts de ligne durs et filets horizontaux. Le sens AD→MD dégrade include::, attributs {x} et conditions en commentaires HTML avec avertissement. L'aller-retour sans perte n'est pas garanti — l'objectif est la justesse d'une migration unique. ## Entrées - **Direction de conversion** (select) - **Document source** (textarea): Paste your Markdown (or AsciiDoc when converting back)… - **Promouvoir le premier H1 en titre de document** (checkbox) - **Garder visible la balise sans équivalent** (checkbox) ## Quand l'utiliser - Migration d'une documentation GitHub Markdown vers un générateur de site comme Antora ou Asciidoctor. - Conversion inverse d'un manuel AsciiDoc vers un README ou un wiki au format Markdown. - Adaptation rapide d'articles techniques contenant des blocs de code, des tableaux et des blocs d'avertissement (admonitions). ## Fonctionnement - Sélectionnez le sens de conversion (Markdown → AsciiDoc ou AsciiDoc → Markdown) et collez votre texte source. - Ajustez les options de structure, comme la promotion automatique du premier titre H1 en titre de document AsciiDoc (=). - L'analyseur convertit les blocs de contenu (titres, tableaux, liens inversés, blocs de code \[source\], admonitions) et signale les balises spécifiques sans équivalent direct. ## Cas d'usage - Transfert de notes de version et de documentations logicielles de dépôts GitHub vers des portails Antora. - Transformation d'articles de documentation interne AsciiDoc pour publication sur des wikis Markdown. - Reprise de tableaux complexes et de snippets de code multilignes sans réécriture manuelle de la syntaxe. ## Questions fréquentes ### Comment sont gérés les niveaux de titres entre Markdown et AsciiDoc ? En Markdown, le titre principal commence par #, alors qu'en AsciiDoc le titre de niveau 1 de section est == et le titre unique du document est =. L'outil gère automatiquement ce décalage. ### Comment sont traitées les alertes GitHub et les admonitions AsciiDoc ? Les alertes GitHub comme `> [!NOTE]` ou `> **Note**` sont traduites en admonitions natives `NOTE:`, `TIP:`, `WARNING:`, et inversement. ### Que deviennent les directives complexes comme include:: ou les attributs en sens inverse ? Lors de la conversion AsciiDoc vers Markdown, les directives sans équivalent GFM sont préservées sous forme de commentaires HTML accompagnés d'un avertissement. ### Les tableaux avec alignement de colonnes sont-ils supportés ? Oui, les tableaux GitHub (`|---|`) sont traduits en blocs `|===` avec directives `cols` respectant les alignements gauche, centré et droit. ### La conversion est-elle parfaitement réversible (aller-retour sans perte) ? Non, les deux langages ayant des expressivités différentes, l'outil privilégie l'exactitude syntaxique pour une migration de code source propre plutôt qu'un cycle sans perte. ## Outils associés - [Convertisseur Markdown vers HTML](https://elysiatools.com/fr/tools/markdown-to-html): Convertit le texte Markdown en HTML avec des options de formatage personnalisables - [Markdown vers Texte Brut](https://elysiatools.com/fr/tools/markdown-to-plain-text): Convertir le texte formaté Markdown en texte brut en supprimant toute la syntaxe et le formatage Markdown - [Fiche de spécifications responsive Figma iOS Android pt dp sp](https://elysiatools.com/fr/tools/figma-ios-android-pt-dp-sp-responsive-design-spec-card): Convertit les valeurs px Figma vers les bonnes unités par plateforme et génère une spec card développeur : pt iOS (@1x/@2x/@3x avec px rendus par échelle), dp/sp Android (table de rendu mdpi…xxxhdpi et échelle de police), rem/vw web avec extrait clamp() fluide ; audit des cibles tactiles minimales (44pt iOS / 48dp Android / 44px et 24px WCAG) avec classes de fenêtres Material et breakpoints Tailwind. - [Comparateur d’algorithmes de hachage](https://elysiatools.com/fr/tools/hash-algorithm-comparator): Hache la même entrée avec MD5, SHA-1, SHA-256, SHA-512, BLAKE2b et BLAKE3 et les compare : longueur, digest hex/Base64, statut de sécurité (cassé/moderne) et benchmark de vitesse relatif. Idéal pour l’enseignement, le choix d’algorithme ou la vérification de checksums. - [Décomposeur d'arbre OKR & KPI](https://elysiatools.com/fr/tools/okr-tree-decomposer): Décompose un Objective d'entreprise en Département → Équipe → Personnel, avec poids/cible/actuel par nœud ; la progression pondérée remonte. Arbre visuel + Markdown. - [IA Image vers Markdown](https://elysiatools.com/fr/tools/ai-image-to-markdown): Extraire le texte des images et convertir en format markdown en utilisant des modèles de vision IA - [Calculateur du Trou Anionique Sérique (AG)](https://elysiatools.com/fr/tools/anion-gap-calculator): Calcule le trou anionique sérique AG = Na⁺ − Cl⁻ − HCO₃⁻ (mmol/L), avec en option la formule avec K⁺ et la correction par l'albumine. AG élevé (≈ >12) oriente vers une accumulation d'anions non mesurés (lactate, corps cétoniques, méthanol/éthylène glycol, salicylés, insuffisance rénale ; moyen mnémotechnique GOLD-MARK). Une acidose métabolique à AG normal (8–12) est hyperchlorémique : diarrhée, acidose tubulaire rénale, perfusion de salé. Un AG bas (<3–6) est le plus souvent lié à une hypoalbuminémie ; également hypercalcémie/hypermagnésémie, lithium, myélome à IgG (paraprotéines cationiques), bromure/pseudo-hyperchlorémie. En cas d'hypoalbuminémie, utiliser la correction AG_corr = AG + 2.5×(4.0 − albumine). Sources : Kraut CJASN 2007, Figge 1998, MDCalc. Interpréter avec gaz du sang et clinique. Non un avis médical. - [Liste indentée vers arbre ASCII](https://elysiatools.com/fr/tools/ascii-tree-from-indented-list): Transforme une liste hiérarchique indentée (2/4 espaces ou tabulation ; préfixes -, *, 1. facultatifs) en arbre ASCII copiable. Deux styles : cadre Unicode et ASCII classique. Options : lignes guides complètes, espaces de fin, feuilles entre crochets. ## Exemples - [Exemples Markdown](https://elysiatools.com/fr/samples/markdown-samples): Exemples de format Markdown de structures simples à complexes - [Echantillons Visionneuse Markdown](https://elysiatools.com/fr/samples/markdown-viewer-samples): Echantillons Markdown pour apercu README, rendu de documentation et tests de balisage - [Exemples de Slides Markdown](https://elysiatools.com/fr/samples/md-slide-deck-to-pdf): Presentations Markdown style Remark/Marp pour tester l export PDF - [Exemples PDF](https://elysiatools.com/fr/samples/pdf-samples): Exemples PDF generes par les outils du 2026-02-01 au 2026-02-10