Éditeur Markdown
Tout reste sur votre appareil.Tout se passe sur votre propre appareil. Rien de ce que vous saisissez n'est jamais envoyé où que ce soit.
Markdown
Aperçu
Votre aperçu généré apparaîtra ici
Rédigez du Markdown avec un aperçu en direct, puis exportez du HTML propre ou le fichier Markdown brut, entièrement dans votre navigateur.
Cet éditeur convertit le Markdown en HTML en direct pendant que vous tapez, entièrement dans votre navigateur, et prend en charge la syntaxe réellement utilisée au quotidien : titres, texte en gras et en italique, liens, images, listes, citations, code en ligne et blocs de code. Tout ce que vous tapez est échappé en HTML avant l'application de tout formatage, de sorte que du HTML collé ou des balises script s'affichent comme du texte visible ordinaire plutôt que d'être exécutés - rien de ce que vous écrivez n'est jamais téléversé où que ce soit.
Questions fréquentes
S'agit-il de la spécification CommonMark complète ?
Non - cela couvre la syntaxe la plus couramment utilisée (titres, emphase, liens, images, listes, citations, code), pas la spécification CommonMark complète avec tous ses cas particuliers comme les listes imbriquées, les tableaux ou les notes de bas de page. Pour les notes quotidiennes, les README et la documentation, ce sous-ensemble de base couvre l'immense majorité du Markdown réel.
Est-il sûr de coller du Markdown provenant d'une source à laquelle je ne fais pas entièrement confiance ?
Oui. Chaque caractère que vous saisissez ou collez est échappé en HTML avant l'application de tout formatage Markdown, et les URL de liens ou d'images sont vérifiées par rapport à une liste blanche de schémas sûrs (http, https, mailto et chemins relatifs) avant d'être utilisées - un lien javascript: collé ou une balise <script> intégrée s'affiche comme du texte visible et inerte plutôt que de s'exécuter.
Quelle est la différence entre les téléchargements HTML et Markdown ?
Le téléchargement Markdown enregistre exactement ce que vous avez tapé, sous forme de fichier .md, pour une édition ultérieure ou un commit dans un dépôt. Le téléchargement HTML enregistre la sortie générée sous forme de fichier .html autonome, prêt à être collé dans un CMS, un e-mail ou tout autre endroit attendant du HTML fini plutôt que la source Markdown.
Pourquoi mes sauts de ligne ont-ils disparu dans l'aperçu ?
L'analyseur suit les règles de paragraphe Markdown standard : les lignes non séparées par une ligne vide sont fusionnées en un seul paragraphe, chaque saut de ligne étant réduit à une simple espace. Pour créer un nouveau paragraphe, laissez une ligne vide entre les blocs de texte - appuyer une seule fois sur Entrée ne créera pas de saut visible dans le résultat affiché.
Le bloc de code prend-il en charge la coloration syntaxique pour un langage comme ```js ?
Pas encore - le langage que vous écrivez après les triples apostrophes inverses d'ouverture sert uniquement à marquer le début du bloc et est ignoré, ni affiché ni coloré. Tout ce qui se trouve à l'intérieur de la clôture est échappé et rendu en texte brut à chasse fixe, donc votre code reste exactement tel que tapé, simplement sans coloration syntaxique.
Prend-il en charge les tableaux ?
Pas encore - cet analyseur se concentre sur la syntaxe la plus couramment utilisée, et les tableaux délimités par des barres verticales n'en font pas partie. Un tableau écrit en syntaxe Markdown s'affichera comme du texte de paragraphe ordinaire plutôt que comme un véritable tableau, donc pour l'instant les tableaux doivent être écrits directement en HTML si vous en avez besoin dans le résultat exporté.
Les listes imbriquées sont-elles prises en charge ?
Non - chaque élément de liste est traité comme plat, quel que soit le nombre d'espaces en début de ligne, donc indenter une ligne pour créer une sous-liste ne produira pas de liste imbriquée ; elle s'affichera plutôt comme un autre élément de premier niveau. Si vous avez besoin d'une hiérarchie, la solution de contournement la plus proche consiste à l'écrire avec des titres ou une indentation manuelle dans un bloc de code.
Est-ce important d'utiliser * ou _ pour le gras et l'italique ?
Non - les deux sont traités de la même façon. **gras** et __gras__ produisent tous deux du texte en gras, et *italique* et _italique_ produisent tous deux du texte en italique. Les boutons B et I de la barre d'outils insèrent toujours la forme avec astérisque, mais taper la forme avec tiret bas fonctionne de façon identique.
Puis-je barrer du texte avec ~~comme ceci~~ ?
Pas actuellement - le texte barré ne fait pas partie de la syntaxe reconnue par cet analyseur, donc ~~texte~~ s'affiche littéralement comme des tildes autour de texte ordinaire plutôt que comme du texte barré. C'est l'une des extensions les plus courantes au-delà du Markdown de base que cet outil ne prend pas encore en charge.
Quelles sont les différentes façons d'écrire une ligne horizontale ?
Trois tirets, astérisques ou tirets bas ou plus sur leur propre ligne - ---, *** ou ___ - s'affichent tous comme une ligne horizontale. Le bouton ― de la barre d'outils insère toujours la forme avec tiret, mais les trois fonctionnent de façon identique si vous les tapez vous-même.
Une citation peut-elle s'étendre sur plusieurs paragraphes ?
Chaque bloc de lignes > consécutives est rendu comme un seul paragraphe à l'intérieur de la citation, les sauts de ligne étant réduits à des espaces, comme pour les paragraphes ordinaires. Laisser une ligne de citation vide pour commencer un second paragraphe dans la même citation n'est pas pris en charge - cela met plutôt fin à la citation.
Puis-je coller du texte formaté depuis Word ou Google Docs ?
Vous pouvez coller dans l'éditeur, mais seulement en texte brut - les navigateurs suppriment la mise en forme riche (gras, titres, liens) lors du collage dans une zone de texte brut, donc les mots survivent mais la mise en forme ne se transforme pas automatiquement en syntaxe Markdown. Vous devrez réappliquer vous-même les titres, le gras et les liens, ce à quoi servent précisément les boutons de la barre d'outils au-dessus de l'éditeur.
À quoi servent les boutons au-dessus de l'éditeur ?
Chacun insère la syntaxe Markdown correspondante à l'endroit de votre curseur, ou l'applique autour du texte que vous avez sélectionné - cliquez sur B avec un mot sélectionné et il devient **mot**, cliquez sur H2 sur une ligne vide et elle devient un titre. Ce sont des raccourcis vers la syntaxe exacte que cet analyseur comprend, pas un système de mise en forme distinct.
Y a-t-il une limite à la quantité de texte que je peux coller ?
Il n'y a pas de limite codée en dur, mais tout le document est réanalysé depuis le début à chaque frappe, entièrement dans le thread principal de votre navigateur. C'est instantané pour des notes et des articles, mais un très grand document (des dizaines de milliers de lignes) peut commencer à sembler poussif pendant la frappe, car il n'y a pas d'analyse incrémentale ou en arrière-plan.
Cela fonctionne-t-il de la même façon pour les langues s'écrivant de droite à gauche comme l'arabe ou le persan ?
Oui - la mise en page de la page passe de droite à gauche pour ces langues, et l'aperçu généré suit la même direction, de sorte que les titres, listes et paragraphes se lisent naturellement. La syntaxe Markdown elle-même (#, *, >, etc.) reste exactement la même, quelle que soit la langue.
Pour les développeurs : ouvrez cette page avec un paramètre `q` dans l'URL - par ex. gizke.com/markdown?q=# Hello world - et cette valeur est préremplie automatiquement. La plupart des visiteurs n'en auront pas besoin ; c'est prévu pour créer un lien direct vers un exemple prêt à l'emploi.