Markdown sur une page.Ce que vous tapez, ce que vous obtenez.

Titres, texte et sauts de ligne

Une ligne vide commence un nouveau paragraphe. Un simple saut de ligne au milieu d’un paragraphe est ignoré, et les lignes se rejoignent. Pour forcer un saut, terminez la ligne par deux espaces ou une barre oblique inverse.

Listes, listes de tâches et tableaux

- Milk
- Bread
  - Rye
  - Wheat

1. Open the folder
2. Pick a file

- [x] Write the plan
- [ ] Review it

Une liste à puces commence chaque ligne par -, * ou +. Indentez de deux ou quatre espaces pour imbriquer. Pour une liste numérotée, seul le premier chiffre doit être juste. Une liste de tâches est une liste à puces avec [ ] ou [x] devant, et s’affiche avec des cases à cocher.

| Plan  | Price | Users |
|-------|------:|:-----:|
| Free  |    $0 |   1   |
| Team  |   $12 |  10   |

Dans un tableau, la deuxième ligne sépare l’en-tête des lignes. :--- aligne une colonne à gauche, ---: à droite et :---: au centre. Les colonnes n’ont pas besoin d’être alignées dans le texte. Pour mettre un | dans une cellule, écrivez \|.

Code

Entourez le code en ligne d’un seul accent grave de chaque côté. Pour un bloc, mettez trois accents graves sur la ligne avant et sur la ligne après, et écrivez le langage après les premiers pour obtenir les couleurs de syntaxe :

```swift
let greeting = "Hello"
```

Un bloc marqué diff colore les lignes qui commencent par + et -. Un bloc marqué mermaid devient un schéma.

Liens et images

[DotMD](https://getdotmd.com)
![A cat on a keyboard](assets/cat.png)
[the plan](plan.md)
[setup](#setup)

Un lien a son texte entre crochets et son adresse entre parenthèses. Une adresse web seule devient aussi un lien. Une image est un lien précédé d’un ! ; son texte la décrit pour les lecteurs d’écran. Les chemins sont relatifs au document, et un lien peut pointer vers un autre fichier .md ou vers un titre, dont l’ancre est son texte en minuscules, les espaces devenant des -.

Pour les adresses longues ou répétées, mettez-les en bas et désignez-les par un nom court : [guide][1], puis [1]: https://example.com/guide sur une ligne à part.

Encadrés, commentaires et front matter

> [!NOTE]
> Useful information that users should know.

Une citation dont la première ligne est [!NOTE], [!TIP], [!IMPORTANT], [!WARNING] ou [!CAUTION] devient un encadré coloré, avec la même syntaxe que sur GitHub.

• Les commentaires qui ne s’affichent pas sur la page : <!-- a note only visible in the text -->.
• Les sections repliables avec <details> et <summary> de HTML, avec des lignes vides autour du Markdown à l’intérieur.
• Le front matter : un bloc entre deux lignes --- tout au début du fichier, avec un titre, des tags ou un statut. DotMD l’affiche comme une carte Properties au-dessus du document.

Formules et schémas

Deux extras que GitHub et DotMD dessinent tous les deux. Une formule se met entre signes dollar, $E = mc^2$, ou entre doubles signes sur une ligne à part : formules Markdown avec LaTeX. Un schéma est un bloc de code marqué mermaid, avec son texte à l’intérieur : schémas Mermaid.

Essayez

Le moyen le plus rapide d’apprendre les signes est de les voir mis en forme. Ouvrez n’importe quel fichier .md dans DotMD et lisez-le mis en forme, avec les tableaux, le code, les encadrés, les schémas et les formules dessinés. La lecture est gratuite. Dans l’éditeur, le menu Insert tape les symboles pour vous, vous n’avez donc rien à retenir de tout cela.

Questions sur la syntaxe Markdown

Plus de questions