Aller au contenu
Tout en local

Convertisseur AsciiDoc en Markdown

Convertissez la syntaxe AsciiDoc en Markdown, et inversement, directement dans votre navigateur.

Entrée

Convertisseur AsciiDoc en Markdown

Collez AsciiDoc — un README, une page de documentation, un morceau exporté d'un wiki — et cet outil le réécrit en Markdown. Les titres (=, ==, jusqu'à ======) deviennent # à ######. Le texte en gras (*mot*) devient **mot**, tandis que l'italique (_mot_) et le code en ligne (`mot`) partagent déjà la même syntaxe dans les deux formats et passent inchangés. link:url[texte] et une simple https://url[texte] deviennent [texte](url), image::url[alt] devient ![alt](url), un bloc [source,langage] encadré par ---- devient un bloc de code délimité, et un tableau |=== devient un tableau Markdown avec une ligne séparatrice d'en-tête. Les admonitions NOTE, TIP, WARNING, IMPORTANT et CAUTION deviennent des blockquotes ou des alertes au style GitHub, et tout fonctionne aussi en sens inverse, de Markdown vers AsciiDoc, via l'option direction.

Les autres options affinent les détails : le style de titre choisit ATX (#) ou Setext (un soulignement de = ou -, niveaux un et deux uniquement — les titres plus profonds reviennent à ATX) ; le format d'admonition choisit une blockquote simple ou un bloc d'alerte GitHub ; le style de puce choisit le tiret ou l'astérisque pour les listes non ordonnées ; et conserver les attributs en en-tête transforme les lignes :nom: valeur d'AsciiDoc en bloc YAML au lieu de les ignorer, reflété également dans la direction inverse.

Ceci est un convertisseur léger basé sur des modèles, pas un analyseur complet, il fonctionne donc mieux sur les constructions ci-dessus. Les listes ordonnées sont toujours rendues en "1." ou "." — les moteurs de rendu numérotent séquentiellement quel que soit le chiffre du marqueur, la numérotation n'est donc pas affectée. Les fins de ligne Windows et Unix sont traitées de la même manière, et le résumé rapporte les lignes en entrée, les lignes en sortie et les éléments convertis.

Tout fonctionne localement dans votre navigateur au fur et à mesure que vous tapez — rien de ce que vous collez n'est téléchargé, enregistré ou envoyé nulle part. Copiez le résultat, téléchargez-le en tant que fichier .txt ou renvoyez-le à l'entrée pour un autre passage.

FAQ

Cela gère-t-il les deux directions — AsciiDoc vers Markdown et Markdown vers AsciiDoc?
Oui. L'option direction change le format qui est lu et celui qui est produit, et le changer aussi redonne la sortie actuelle à l'entrée, pour que vous puissiez convertir d'une manière et puis vérifier l'aller-retour.
Pourquoi les listes ordonnées sont-elles toujours affichées comme "1." ou "."?
Les moteurs de rendu Markdown et AsciiDoc numérotent les listes ordonnées séquentiellement peu importe quel chiffre ou nombre de points se trouve sur chaque ligne source, donc écrire chaque marqueur de la même manière produit toujours une sortie correctement numérotée sans que le convertisseur ait à suivre les compteurs.
Que se passe-t-il avec les constructions AsciiDoc que cet outil ne reconnaît pas?
Tout ce qui est en dehors de l'ensemble pris en charge — titres, gras, liens, images, blocs de code, tableaux une ligne par ligne, admonitions, listes et attributs :nom: valeur — est laissé en tant que texte brut plutôt que deviné, de sorte que la sortie reste prévisible au lieu de mutiler silencieusement les balises inconnues.
Peut-il convertir des tableaux imbriqués ou multi-lignes?
Il prend en charge la forme compacte courante où chaque ligne de tableau se trouve sur sa propre ligne entre les délimiteurs |=== (AsciiDoc) ou sous forme de tableau de tuyau standard avec une ligne séparatrice d'en-tête (Markdown). Les tableaux AsciiDoc écrits avec une cellule par ligne et des séparateurs de ligne vierge ne sont pas reconstruits.
Mon document est-il téléchargé quelque part?
Non. La conversion s'exécute entièrement dans votre navigateur — rien de ce que vous collez ne quitte jamais votre appareil.