Générateur de blocs de code Markdown
Placez du code dans un bloc de code Markdown avec le bon langage pour la coloration syntaxique, choisissez le délimiteur et transformez-le si besoin en section repliable.
Chargement de Générateur de blocs de code Markdown…
Vos fichiers ne quittent jamais votre appareil
Comment utiliser Générateur de blocs de code Markdown
- 1
Ouvrez Générateur de blocs de code Markdown sur cette page. Il se charge directement dans votre navigateur.
- 2
Ajoutez votre fichier, texte ou valeurs et ajustez les réglages.
- 3
Copiez ou téléchargez le résultat. Rien n'est envoyé ni stocké.
À propos de cet outil
Partager du code dans un README, une issue GitHub, sur Discord ou Stack Overflow fonctionne mieux dans un bloc de code délimité avec le langage indiqué : il garde sa mise en forme et bénéficie de la coloration syntaxique. Ce générateur de blocs de code Markdown encadre votre code correctement, même quand le code contient lui-même des accents graves, et peut ranger les longs extraits dans une section repliable.
Comment créer un bloc de code
- Collez votre code.
- Choisissez le langage, comme JavaScript, Python, Bash, JSON ou SQL.
- Choisissez le délimiteur : trois accents graves, ou des tildes quand votre code contient des accents graves.
- Activez si vous le souhaitez une section repliable et écrivez son texte de résumé.
- Vérifiez l'aperçu et copiez le Markdown.
Ce que l'outil produit
```python
print("Hello")
```
Le nom du langage après le délimiteur d'ouverture indique à GitHub, GitLab, Discord et aux outils de documentation comment colorer le code.
Code repliable
Les longs journaux et fichiers de configuration peuvent noyer le reste d'une issue. L'option repliable place le bloc dans un élément details avec votre résumé comme titre cliquable, par exemple « Journal d'erreur complet », pour que les lecteurs l'ouvrent quand ils en ont besoin.
Conseils
- Indiquez toujours le langage ; le code devient bien plus lisible.
- Utilisez diff comme langage pour montrer les lignes ajoutées et supprimées avec + et -.
- Raccourcissez les longues sorties à la partie utile avant de les partager.
- Retirez les secrets comme les clés d'API et les mots de passe du code avant de le publier.
Pour plus de Markdown, consultez l'aide-mémoire Markdown, ou écrivez tout un document dans l'éditeur Markdown.
Questions fréquentes
Comment ajouter un bloc de code en Markdown ?
Placez trois accents graves sur la ligne avant et après le code, et écrivez le nom du langage juste après les trois premiers, par exemple ```javascript.
Comment afficher du code qui contient des accents graves ?
Utilisez un délimiteur plus long ou des tildes (~~~) autour du bloc, ce que le générateur peut faire pour vous, afin que les accents graves intérieurs ne ferment pas le bloc.
Quels langages sont colorés ?
La coloration est faite par le site qui affiche votre Markdown. GitHub, GitLab et la plupart des outils prennent en charge les langages courants comme JavaScript, Python, Bash, JSON et SQL.
Comment créer un bloc de code repliable ?
Activez l'option repliable et saisissez un résumé. Le bloc est placé dans un élément details que les lecteurs peuvent déplier.
Comment afficher un diff ?
Utilisez diff comme langage et commencez les lignes modifiées par + ou -. Elles apparaissent en vert et en rouge sur GitHub.
Est-ce que ça marche dans Discord et Slack ?
Discord prend en charge les blocs de code délimités avec langage. Slack prend en charge les blocs de code mais pas la coloration par langage.