Voici quelques exemples de syntaxe Markdown de base que vous pouvez utiliser lors de la rédaction de contenu Markdown dans Astro.
Titres
Vous devriez éviter de recréer le titre de l'article dans le corps du Markdown, car le titre de l'article sera automatiquement généré à partir du title
dans le frontmatter
.
Évitez une hiérarchie de titres trop profonde, généralement trois niveaux suffisent.
Niveau 1
Niveau 2
Niveau 3 code en ligne
Niveau 4
Niveau 5
Niveau 6
Paragraphes
Xerum, quo qui aut unt expliquam qui dolut labo. Aque venitatiusda cum, voluptionse latur sitiae dolessi aut parist aut dollo enim qui voluptate ma dolestendit peritin re plis aut quas inctum laceat est volestemque commosa as cus endigna tectur, offic to cor sequas etum rerum idem sintibus eiur? Quianimin porecus evelectur, cum que nis nust voloribus ratem aut omnimi, sitatur? Quiatem. Nam, omnis sum am facea corem alique molestrunt et eos evelece arcillit ut aut eos eos nus, sin conecerem erum fuga. Ri oditatquam, ad quibus unda veliamenimin cusam et facea ipsamus es exerum sitate dolores editium rerore eost, temped molorro ratiae volorro te reribus dolorer sperchicium faceata tiustia prat.
Utilisez deux espaces à la fin de la ligne pour un saut de ligne dans le paragraphe
All work and no play makes Jack a dull boy.
All work and no play makes Jack a dull boy.
Images
Image de petite taille
Image de grande taille
Image avec titre
Emphase
Ceci est un contenu important, ceci est un contenu secondaire
Barré
Ceci est un texte barré.
Citations
L'élément blockquote représente un contenu cité d'une autre source, optionnellement avec une citation qui doit être dans un élément footer
ou cite
, et optionnellement avec des modifications en ligne telles que des annotations et des abréviations.
Tiam, ad mint andaepu dandae nostion secatur sequo quae.
Notez que vous pouvez utiliser la syntaxe Markdown dans une citation.
Citation imbriquée
Citation
Citation imbriquée
Citation avec note de bas de page
Don't communicate by sharing memory, share memory by communicating.
— Rob Pike1
Ligne horizontale
Liens
Ceci est un lien interne Guide d'utilisation de Gyoza
Ceci est un lien externe Documentation React en français
Rendu automatique en lien https://github.com
Adresse e-mail mail@example.com
Tableaux
Définir l'alignement des cellules
Nom | Âge | Fruit |
---|---|---|
Bob | 27 | Pomme |
Alice | 23 | Banane |
John | 28 | Orange |
Supporte le Markdown en ligne
Italique | Gras | Code |
---|---|---|
italique | gras | code |
Débordement de tableau
A | B | C | D | E | F |
---|---|---|---|---|---|
Lorem ipsum dolor sit amet, consectetur adipiscing elit. | Phasellus ultricies, sapien non euismod aliquam, dui ligula tincidunt odio, at accumsan nulla sapien eget ex. | Proin eleifend dictum ipsum, non euismod ipsum pulvinar et. Vivamus sollicitudin, quam in pulvinar aliquam, metus elit pretium purus | Proin sit amet velit nec enim imperdiet vehicula. | Ut bibendum vestibulum quam, eu egestas turpis gravida nec | Sed scelerisque nec turpis vel viverra. Vivamus vitae pretium sapien |
Blocs de code
Syntaxe
Nous pouvons utiliser 3 backticks ``` sur une nouvelle ligne et écrire le snippet, puis fermer avec 3 backticks sur une nouvelle ligne. Pour mettre en évidence la syntaxe spécifique à un langage, écrivez un mot du nom du langage après les 3 premiers backticks, par exemple html, javascript, css, markdown, typescript, txt, bash
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8" />
<title>Example HTML5 Document</title>
</head>
<body>
<p>Test</p>
</body>
</html>
const var text = "hello world"
Formules KaTeX
Utilisez le symbole $
pour encadrer une formule et générer une formule en ligne, par exemple : .
Utilisez le symbole $$
pour encadrer une formule et générer une formule indépendante. Par exemple :
Vous pouvez également utiliser la méthode du bloc de code (```math
) :
Types de listes
Liste ordonnée
Syntaxe
1. Premier élément
2. Deuxième élément
3. Troisième élément
Résultat
- Premier élément
- Deuxième élément
- Troisième élément
Liste non ordonnée
Syntaxe
- Élément de liste
- Un autre élément
- Et encore un autre élément
Résultat
- Élément de liste
- Un autre élément
- Et encore un autre élément
Liste imbriquée
Syntaxe
- Fruit
- Pomme
- Orange
- Banane
- Produits laitiers
- Lait
- Fromage
Résultat
- Fruit
- Pomme
- Orange
- Banane
- Produits laitiers
- Lait
- Fromage
Autres éléments — abbr, sub, sup, kbd, mark
Syntaxe
<abbr title="Graphics Interchange Format">GIF</abbr> est un format d'image bitmap.
H<sub>2</sub>O
X<sup>n</sup> + Y<sup>n</sup> = Z<sup>n</sup>
Appuyez sur <kbd><kbd>CTRL</kbd>+<kbd>ALT</kbd>+<kbd>Suppr</kbd></kbd> pour terminer la session.
La plupart des <mark>salamandres</mark> sont nocturnes et chassent les insectes, les vers et d'autres petites créatures.
Résultat
GIF est un format d'image bitmap.
H2O
Xn + Yn = Zn
Appuyez sur CTRL+ALT+Suppr pour terminer la session.
La plupart des salamandres sont nocturnes et chassent les insectes, les vers et d'autres petites créatures.
Spoiler
||cacher le contenu||
En temps normal, ce contenu sera caché cacher le contenu, et ne s'affichera que lorsque la souris passera dessus.
Intégrations
Pour intéger du contenu Codepen ou Youtube, on peut utiliser la syntaxe suivante
Codepen
::codepen{#dPbmrj author="ricardospalves"}
YouTube
::youtube{#jNQXAC9IVRw}
Sources
-
La citation ci-dessus est extraite de la conférence de Rob Pike lors du Gopherfest, le 18 novembre 2015. ↩