1Tools

44 lines · 976 chars

Markdown

Aperçu

Encodage et texte

Aperçu Markdown

Un aperçu Markdown vous montre la version rendue de votre Markdown pendant que vous tapez — écrivez ou collez à gauche, lisez le résultat formaté à droite. C’est une visionneuse Markdown en direct qui tourne entièrement dans le navigateur : ouvrez un fichier .md depuis votre disque, ou collez un README tiré d’un dépôt, et l’aperçu se met à jour au fil de la frappe. GitHub Flavored Markdown est pris en charge, donc tableaux, listes de tâches, barré et blocs de code s’affichent comme attendu. Rien de ce que vous tapez n’est envoyé, et il n’y a pas de compte à créer.

Ce que vous pouvez faire

  • Aperçu en direct pendant la frappe

    Tapez dans l’éditeur à gauche et la page rendue à droite se met à jour pendant que vous écrivez. Pas de bouton Aperçu à cliquer ni de rechargement — c’est un aperçu Markdown en direct, pas une étape de rendu séparée.

  • Ouvrir un .md, ou le déposer

    Lisez un fichier Markdown en ligne depuis votre disque : choisissez un .md, glissez-le sur l’éditeur, ou collez le texte d’un README copié depuis un dépôt. L’aperçu se remplit dès que le fichier est chargé.

  • GitHub Flavored Markdown

    Tableaux, listes de tâches, barré, URL auto-liées, notes de bas de page et blocs de code clôturés sont rendus comme sur GitHub, pour qu’un README ait ici le même aspect qu’après le push.

  • Une table des matières qui suit

    Chaque titre du document est regroupé dans un plan cliquable, avec des ancres alignées sur celles de GitHub. Cliquez un titre pour y aller — un long README cesse d’être un défilement sans fin et devient un document navigable.

  • Formules mathématiques, et un PDF à garder

    Les formules LaTeX entre signes dollar sont composées avec mathématiques style LaTeX, le même moteur que la plupart des sites Markdown. Quand le document est prêt, imprimez l’aperçu et enregistrez-le en PDF depuis le navigateur — le texte reste net et sélectionnable, et les formules survivent.

  • Sûr par défaut, et entièrement local

    Le HTML brut intégré au Markdown n’est pas exécuté, donc un document ne peut pas lancer de scripts dans votre navigateur. Le rendu se fait sur votre machine : pas d’envoi, pas de compte, pas de copie du fichier stockée sur un serveur.

Comment l’utiliser

  1. 01

    Placez votre Markdown dans l’éditeur. Tapez-le, collez-le, choisissez un .md sur le disque, ou déposez-en un sur la page. Le README d’exemple se charge si vous voulez juste voir comment l’aperçu fonctionne.

  2. 02

    Lisez le résultat rendu à droite. L’aperçu se met à jour pendant que vous tapez, donc titres, tableaux, listes, liens, formules et blocs de code apparaissent exactement comme à la publication. Faites glisser le séparateur pour donner plus de place à un côté, ou passez aux onglets Éditer et Aperçu sur téléphone.

  3. 03

    Emportez la sortie dont vous avez besoin. Copiez le HTML rendu pour un CMS ou une page de docs, téléchargez le fichier en .md, ou appuyez sur Exporter PDF et enregistrez-le depuis la boîte de dialogue d’impression du navigateur. Quand vous avez fini, videz l’éditeur — tout s’est passé sur votre appareil.

Ce qu’est un aperçu Markdown, et quand vous en avez besoin

  • Ce qu’est un fichier Markdown

    Un fichier Markdown est du texte brut avec quelques signes de ponctuation qui indiquent au moteur de rendu ce que signifie chaque ligne : deux dièses font un titre, une barre verticale un tableau, un tiret et deux espaces un élément de liste. Le fichier lui-même ne porte aucun formatage, c’est pourquoi il s’ouvre partout en texte brut. Un aperçu Markdown rend ce texte comme le ferait un site web, pour que vous voyiez le résultat plutôt que la source. C’est toute l’idée de cette page : le .md reste ce qu’il est, et le côté droit montre ce qu’il devient.

  • Quand un visualiseur en ligne aide

    On cherche une visionneuse Markdown en ligne pour des raisons pratiques. Vous avez tiré un README d’un dépôt et voulez savoir comment il apparaîtra sur votre site, où les chemins d’images relatifs, les tableaux et les badges se comportent autrement que sur GitHub. Ou vous rédigez un README et voulez vérifier qu’un tableau s’affiche avant le push. Ou vous lisez un fichier de documentation sur la machine de quelqu’un d’autre et préférez ne rien installer. Ouvrir cette page règle les trois cas : tapez ou ouvrez le fichier, lisez l’aperçu, emportez ce dont vous avez besoin. Pas de plugin à installer, pas de paquet Node à ajouter, pas d’éditeur à configurer.

  • Navigation, formules et PDF pour les longs documents

    Les longs documents ont deux extras utiles. Les titres sont regroupés dans une table des matières cliquable avec les mêmes ids d’ancre que GitHub, donc un lien de section fonctionne comme prévu et un document de cinquante pages n’est plus un seul défilement. Et quand le document contient des mathématiques — une formule entre signes dollar — elle est composée correctement avec mathématiques style LaTeX plutôt qu’affichée en LaTeX brut. Quand le brouillon est terminé, l’aperçu s’imprime comme un document et vous l’enregistrez en PDF depuis le navigateur, avec le texte encore sélectionnable et les formules intactes.

  • Deux limites à connaître avant de compter dessus

    Deux limites à connaître avant de s’y fier. Premièrement, l’aperçu suit GitHub Flavored Markdown — titres, listes, tableaux, listes de tâches, barré, autoliens, notes de bas de page et blocs de code clôturés — mais ce n’est pas un système de publication complet : les liens de référence vers des fichiers hors document et les pages HTML personnalisées sont hors périmètre. Deuxièmement, le HTML intégré est rendu comme du texte plutôt qu’exécuté, et les images sont chargées depuis l’URL que vous indiquez, donc une image à côté du .md sur le disque n’apparaîtra pas sauf si vous l’hébergez ou l’intégrez en data URI. Dans ces deux limites, ce que vous voyez dans l’aperçu est ce qu’un moteur compatible GitHub produit pour le même fichier.

Privé, rapide et gratuit

  • 100 % dans votre navigateur

    Le rendu se fait sur votre appareil. Votre Markdown n’est jamais envoyé, et aucune copie n’est stockée.

  • Sans inscription

    Ouvrez la page et commencez à écrire. Pas de compte, pas de connexion, pas de plugin à installer.

  • Aucun HTML brut exécuté

    Le HTML intégré est rendu comme du texte, donc un document ne peut pas lancer de scripts dans votre navigateur.

  • Compatible GitHub

    GitHub Flavored Markdown est pris en charge, donc votre README a l’aspect qu’il aura après le push.

FAQ

Différence de texte & comparaisonEncodeur et décodeur Base64Formateur et validateur JSONTous les outilsRetour à l’accueil

Un cas de rendu que cette page ne couvre pas ?

Dites-le-nous — diagrammes Mermaid, téléchargement .pdf direct, export vers des fichiers HTML et notes dans l’aperçu sont les demandes que nous lisons le plus.

Envoyer un avis