Guide Markdown
Les essentiels pour écrire une présentation dans MarpNative : Markdown de base, slides MARP, layouts, images et notes. Les menus Blocks, Images et Layout de l’app insèrent la plupart de ces snippets pour vous.
1. Anatomie d’une présentation
Un fichier MarpNative est un fichier .md classique. En haut, un front-matter entre deux lignes --- décrit le thème et les options. Ensuite viennent les slides, séparées aussi par ---.
---
marp: true
theme: atlas
paginate: true
---
# Titre de la première slide
Texte d’introduction
---
## Deuxième slide
- Point A
- Point Bmarp: true— active le mode présentationtheme:— nom du thème (atlas,pitch, etc.)paginate: true— numérote les slides (selon le thème)
Astuce. Le sélecteur de thème de l’app écrit automatiquement theme: dans le front-matter.
2. Markdown de base
Disponible aussi via le menu Blocks au-dessus de l’éditeur.
| Effet | Syntaxe |
|---|---|
| Titre niveau 1 | # Titre |
| Titre niveau 2 | ## Sous-titre |
| Titre niveau 3 | ### Rubrique |
| Gras | **texte** |
| Italique | _texte_ |
| Barré | ~~texte~~ |
| Surligné | ==texte== |
| Code inline | `code` |
| Indice / exposant | <sub>…</sub> · <sup>…</sup> |
| Lien | [libellé](https://…) |
| Liste | - élément ou 1. élément |
| Citation | > citation |
3. Slides MARP
Chaque slide est le contenu situé entre deux séparateurs --- (après le front-matter).
---
# Slide A
Contenu
---
# Slide B
Autre contenuPiège courant. Ne collez pas plusieurs layouts _class sur la même slide sans --- entre eux. Une directive layout = une slide.
4. Layouts (_class)
Les thèmes exposent des mises en page (cover, section, quote…). On les active avec un commentaire HTML en tête de slide :
---
<!-- _class: cover -->
# Titre d’ouverture
Sous-titreLes classes disponibles dépendent du thème actif. Le menu Layout de l’app les liste et les insère pour vous. Dans le Theme Store, chaque fiche thème documente ses layouts et propose un exemple chargeable.
5. Images
Syntaxe Markdown standard, enrichie par les directives Marp. Le menu Images de la toolbar insère ces snippets.
Image simple (fichier local)
Placez l’image à côté du .md (souvent dans un dossier assets/) :
Important. Pour attacher une image locale, enregistrez d’abord la présentation : l’app copie alors le fichier dans assets/ à côté du document.
Image depuis une URL
Largeur
Fonds Marp
| Effet | Syntaxe |
|---|---|
| Fond plein écran |  |
| Fond à droite (40 %) |  |
| Fond à gauche (40 %) |  |
| Fond en bas |  |
Mots-clés selon le thème
Certains thèmes ajoutent des mots-clés (ex. Atlas : center, right, rounded). Consultez la fiche du thème dans le Theme Store ou son fichier example.md.
6. Notes orateur
Les notes ne s’affichent pas sur la slide projetée. Insérez-les via le menu Blocks (« Speaker Notes ») :
<!-- notes: Points à rappeler à voix haute -->7. Astuces MarpNative
- Blocks — titres et formatage inline d’un clic
- Images — insertion locale, URL, largeur et fonds Marp
- Layout — classes
_classdu thème actif - Theme Store — previews, docs des layouts, bouton « Charger l’exemple »
- Export — PDF (une page par slide) et PNG depuis le menu Exporter
- Vos fichiers restent du
.mdstandard, lisible aussi avec Marp CLI ou VS Code