Un aperçu Markdown en ligne pour vérifier avant de publier
Cet éditeur Markdown en ligne est gratuit et utilisable sans inscription. Un titre qui reste en texte brut, un tableau mal aligné, une image absente : testez votre Markdown en ligne et repérez ce qui coince au fil de la saisie. Sur grand écran, le texte source et son aperçu s’affichent côte à côte ; sur un écran étroit, l’aperçu se trouve sous l’éditeur.
Ouvrir un fichier .md sans installer de logiciel
Vous avez reçu un README ou une documentation en Markdown ? Ouvrez le fichier pour le lire avec ses titres, ses listes et ses tableaux. Vous pouvez aussi remplacer l’exemple déjà présent par votre propre texte.
Collez le texte ou ouvrez votre fichier
Utilisez l’icône « Ouvrir un fichier .md » dans la barre de l’éditeur. Les extensions .md et .markdown sont acceptées, dans la limite indiquée à côté du nom de l’éditeur. Le fichier remplace le texte affiché.
Modifiez la source et observez le rendu
L’aperçu s’actualise pendant la saisie, sans bouton de validation. Agrandissez l’un des panneaux en plein écran pour relire un document long. Vous modifiez la syntaxe Markdown dans l’éditeur ; l’aperçu sert à voir le résultat.
Récupérez le contenu qui vous convient
L’icône de copie de l’aperçu permet de copier le contenu avec sa mise en forme si le navigateur prend en charge cette fonction et autorise la copie. Si la copie avec mise en forme n’est pas prise en charge, la copie se fait en Markdown brut lorsque le navigateur le permet. En cas d’échec, sélectionnez et copiez le texte dans l’éditeur. Utilisez aussi cette méthode pour reprendre la source dans un README. Le fichier d’origine sur votre ordinateur n’est pas modifié.
Pourquoi mon tableau Markdown ne s’affiche-t-il pas ?
Un tableau a besoin d’une ligne de séparation entre l’en-tête et les données. Pour essayer, remplacez le contenu de l’éditeur par ces trois lignes, hors d’un bloc de code. Copiez d’abord votre texte ailleurs si vous souhaitez le conserver :| Document | État || --- | --- || README | À relire |
Supprimez la deuxième ligne, | --- | --- | : les deux lignes restantes ne forment plus un tableau. Remettez cette ligne entre l’en-tête et les données pour retrouver les deux colonnes.
Gardez le même nombre de colonnes dans l’en-tête et sa ligne de séparation. Si tout s’affiche comme du code, vérifiez que le tableau n’est pas entouré de triples accents graves. Pour préparer un tableau plus large, utilisez le générateur de tableaux Markdown.
Pour publier sur GitHub, consultez aussi la documentation officielle sur les tableaux : elle détaille notamment l’alignement des colonnes et l’écriture d’une barre verticale dans une cellule.
Sauts de ligne et images : deux vérifications utiles
Un retour à la ligne ne crée pas toujours une nouvelle ligne
Dans cet aperçu, appuyer une fois sur Entrée au milieu d’un paragraphe ne force pas un saut de ligne. Laissez une ligne vide pour commencer un nouveau paragraphe, ou ajoutez deux espaces en fin de ligne avant d’appuyer sur Entrée pour rester dans le même paragraphe. Vous pouvez aussi terminer la ligne par une barre oblique inverse (\).
Essayez ces deux lignes :Première ligneDeuxième ligne
Elles restent dans le même paragraphe, sans saut de ligne forcé. Ajoutez ensuite une barre oblique inverse à la fin de la première ligne :Première ligne\Deuxième ligne
L’aperçu affiche alors un saut de ligne entre les deux phrases.
Une image locale n’est pas importée avec le fichier .md
Une référence comme  ne donne pas accès au dossier de votre ordinateur ni aux fichiers de votre dépôt. Ouvrir le Markdown n’importe pas les images qui l’accompagnent. Pour vérifier une image distante, utilisez son adresse HTTPS complète.
Comparez  avec . La première forme dépend de l’emplacement du document ; la seconde indique une adresse complète. L’adresse example.org est illustrative : remplacez-la par l’URL HTTPS d’une image accessible pour faire l’essai. Une adresse complète ne suffit pas si l’hébergeur bloque son affichage.
Une adresse d’image doit être accessible
Vérifiez que le lien mène au fichier image, et non à une page qui le présente. Une image réservée aux utilisateurs connectés ou dont l’hébergeur refuse l’affichage depuis un autre site peut rester invisible. Testez l’adresse séparément dans votre navigateur.
Prévisualiser un README avant de le publier sur GitHub
Ouvrez votre README.md et relisez-le comme le ferait un nouveau contributeur : les titres organisent-ils clairement les instructions ? Les commandes sont-elles dans des blocs de code ? Les listes de tâches et les tableaux restent-ils lisibles ?
Cet aperçu aide à vérifier la structure, mais ne reproduit pas exactement le rendu de GitHub. Les styles, certaines extensions et la résolution des liens relatifs peuvent différer. Terminez la relecture dans l’aperçu de votre dépôt, surtout pour les images et les liens vers d’autres fichiers.