« Word est trop lourd et les formats ne sont pas portables ; le texte brut n'a pas de mise en forme. Je veux un format d'écriture léger qui utilise du texte brut pour les titres, listes, coloration syntaxique — mais je ne maîtrise pas la syntaxe Markdown. »
L'éditeur Markdown Suried offre un aperçu en temps réel — écrivez la syntaxe Markdown à gauche, voyez le rendu instantanément à droite. Ce guide vous emmène de votre premier titre à la maîtrise de toute la syntaxe Markdown courante en 10 minutes.
01 Qu'est-ce que le Markdown ?
Markdown est un langage de balisage léger créé par John Gruber en 2004. Sa philosophie : écrire en texte brut, utiliser des symboles simples (comme # pour les titres, ** pour le gras) pour la mise en forme, avec une excellente lisibilité — la structure du contenu est claire même sans rendu.
Markdown est devenu le standard de facto pour la rédaction technique — README GitHub, blogs tech, documentation API, applications de notes (Notion, Obsidian) utilisent tous Markdown. Apprendre le Markdown, c'est maîtriser un langage d'écriture universel.
Contrairement aux éditeurs de texte riche comme Word/Pages, les fichiers Markdown sont en texte brut (.md) — taille minimale, compatibilité multiplateforme, adapté au contrôle de version, et la mise en forme ne se corrompt jamais.
02 Syntaxe de base : titres, gras, italique
Les titres utilisent le symbole #. # Titre 1 (le plus grand), ## Titre 2, ### Titre 3, jusqu'à ###### Titre 6. Un espace est requis entre # et le texte.
Le gras utilise des doubles astérisques : **texte en gras**. L'italique utilise des astérisques simples : *texte en italique*. Le gras italique utilise des triples astérisques : ***gras italique***. Les tirets bas fonctionnent aussi : __gras__, _italique_, mais les astérisques sont la convention communautaire.
Le texte barré utilise des doubles tildes : ~~texte supprimé~~. Le code en ligne utilise des accents graves : `console.log()`. Les deux sont fréquemment utilisés dans la documentation technique.
Dans l'éditeur Suried, Ctrl+B bascule le gras et Ctrl+I bascule l'italique, pour formater rapidement sans mémoriser la syntaxe.
03 Liens et images
Syntaxe des liens : [texte affiché](URL). Par exemple, [Google](https://google.com) s'affiche comme un hyperlien cliquable. Vous pouvez ajouter un titre après l'URL : [Google](https://google.com "Moteur de recherche").
La syntaxe des images est similaire aux liens avec un point d'exclamation en préfixe : . Par exemple, . Le texte alternatif fournit une solution de repli si l'image ne charge pas et assure l'accessibilité.
Les liens de référence sont idéaux pour réutiliser la même URL plusieurs fois : définissez [nom du site]: URL d'abord, puis référencez avec [texte affiché][nom du site]. Cela maintient la gestion des liens propre dans les longs documents.
04 Blocs de code
Le code en ligne utilise des accents graves simples : `const x = 1`. Les blocs de code multilignes utilisent des barrières de trois accents graves, avec un identifiant de langage après les accents ouvrants pour la coloration syntaxique :
Les identifiants de langage supportés incluent : javascript / js, typescript / ts, python, html, css, json, bash / sh, sql, et plus. L'éditeur Suried prend en charge la coloration syntaxique pour un large éventail de langages.
Si votre code contient des accents graves, enveloppez le code en ligne avec des doubles accents : ``code with `backtick` ``. Tout à l'intérieur d'un bloc de code est affiché tel quel — le rendu Markdown est suspendu.
05 Listes et tableaux
Les listes non ordonnées commencent par -, * ou + (- est recommandé). Les listes ordonnées utilisent des numéros avec des points : 1., 2., 3.. Les listes imbriquées sont créées par indentation (2 ou 4 espaces).
Les listes de tâches (TODO) utilisent - [ ] pour les éléments non complétés et - [x] pour les complétés. Extrêmement utiles dans les Issues GitHub et la documentation de gestion de projet. L'éditeur Suried les affiche comme des cases à cocher interactives.
Les tableaux utilisent des barres verticales | pour séparer les colonnes et --- pour séparer les en-têtes des lignes de contenu. L'alignement est contrôlé avec des deux-points : :--- aligné à gauche, :---: centré, ---: aligné à droite. Bien que la syntaxe des tableaux Markdown soit verbeuse, l'aperçu en temps réel de l'éditeur Suried permet de vérifier le résultat instantanément.
Les tableaux Markdown ne sont pas adaptés aux mises en page complexes (comme la fusion de cellules). Pour les tableaux complexes, utilisez directement les balises HTML <table> — Markdown supporte le HTML en ligne.
FAQ
Quel est le lien entre Markdown et HTML ?
Le Markdown est essentiellement converti en HTML pour le rendu. # Titre devient <h1>Titre</h1>, **gras** devient <strong>gras</strong>. Le Markdown est une écriture HTML simplifiée, et vous pouvez intégrer des balises HTML directement dans les fichiers Markdown.
L'éditeur Markdown Suried prend-il en charge les formules mathématiques ?
Oui, il prend en charge la syntaxe KaTeX / LaTeX pour les formules mathématiques. Les formules en ligne utilisent $ : $E = mc^2$. Les blocs de formules utilisent $$. Parfait pour la rédaction de documentation technique et de notes académiques.
La syntaxe Markdown est-elle exactement la même sur toutes les plateformes ?
La syntaxe de base (titres, gras, listes) est la même partout. Mais chaque plateforme a ses extensions — GitHub Flavored Markdown (GFM) ajoute les listes de tâches, tableaux, texte barré, etc. ; CommonMark est l'effort de standardisation. L'éditeur Suried est compatible GFM.
Comment créer des sauts de ligne en Markdown ?
En Markdown, appuyer sur Entrée une fois ne crée pas de saut de ligne — il faut deux espaces en fin de ligne puis Entrée (saut forcé), ou une ligne vide pour un nouveau paragraphe. C'est l'un des choix de conception les plus déroutants du Markdown pour les débutants. L'aperçu en temps réel de l'éditeur Suried montre clairement les effets de saut de ligne.
Puis-je utiliser le Markdown pour des livres ou de longs documents ?
Absolument ! De nombreux livres techniques sont écrits en Markdown (Gitbook, mdBook, etc.). Avec les générateurs de table des matières, les références croisées et les outils d'export, le Markdown est tout à fait capable pour la rédaction longue. La fonction d'export de l'éditeur Suried peut convertir le Markdown en HTML élégant ou télécharger en fichiers .md.
Try the Tool Now
L'éditeur Markdown Suried offre un aperçu en temps réel — écrivez la syntaxe Markdown à gauche, voyez le rendu instantanément à droite. Ce guide vous emmène de votre premier titre à la maîtrise de toute la syntaxe Markdown courante en 10 minutes.