L’import Markdown est en bêta. Cet outil d’import prend en charge la syntaxe Deckset des présentations Markdown courantes. Il donne les meilleurs résultats lorsque votre présentation utilise du Markdown standard et des commandes de présentation pour les séparateurs de diapositives, les arrière-plans, les images, les notes et les pieds de page.

Importer un fichier Markdown

Pour importer une présentation Markdown dans Figma, ouvrez le plugin Pitchdeck et glissez un fichier .md, .markdown ou .zip depuis votre ordinateur dans la zone de dépôt d’import, sous la liste des diapositives. Vous pouvez aussi cliquer sur la zone de dépôt pour parcourir vos fichiers.

Si votre présentation a été écrite pour Deckset, vous pouvez importer directement le même fichier Markdown. Pitchdeck prend en charge la syntaxe de type Deckset pour les séparateurs de diapositives, les notes de l’orateur, les images, les pieds de page, les numéros de diapositive et les autres commandes de présentation prises en charge.

Pitchdeck crée une nouvelle page dans votre fichier Figma actuel, puis ajoute chaque diapositive Markdown sous la forme d’un frame de diapositive Figma modifiable. La plupart des contenus importés deviennent des calques Figma ordinaires (texte, image, vecteur et mise en page), ce qui vous permet de continuer à modifier la présentation après l’import.

Regroupez les médias locaux et votre fichier Markdown dans un ZIP. Si votre fichier Markdown fait référence à des images, des SVG, des vidéos ou des fichiers audio locaux, créez un fichier .zip qui contient un seul fichier .md ou .markdown et tous les fichiers médias locaux qu’il référence. Si vous ne voulez pas regrouper les fichiers locaux, utilisez plutôt des URL externes directes pour les images ou les médias.

Contenu Markdown pris en charge

L’import Markdown prend en charge les contenus de présentation courants et les importe, dans la mesure du possible, en calques Figma modifiables :

• Titres, paragraphes, citations, code en ligne, blocs de code et formules, en texte modifiable.
• Gras, italique, barré, exposant, indice, liens dans le texte et mise en forme simple du texte avec <span style="">.
• Listes à puces, numérotées, imbriquées et listes dont la numérotation vient de la source.
• Tableaux avec alignement de base.
• Notes de bas de page, y compris les notes nommées et les notes sur plusieurs lignes.
• Notes de l’orateur issues des lignes ^ note.
• Ancres et liens entre diapositives, y compris les liens [Jump](#slide-anchor).
• Images dans le texte, images d’arrière-plan, images divisées gauche/droite, rangées d’images, SVG distants et espaces réservés pour les médias manquants.
• Références vidéo et audio, sous forme de métadonnées de médias ou d’espaces réservés.
• Diagrammes Mermaid de type flowchart, graph et pie, en diagrammes vectoriels.
• Diagrammes Pikchr à boîtes et flèches, en diagrammes vectoriels.

Commandes de présentation

Vous pouvez ajouter des commandes en haut du fichier Markdown pour piloter l’ensemble de l’import :

autoscale: true
background-image: hero.png
build-lists: notFirst
fit-header: #, ##
footer: Confidential
image-corner-radius: 18
paragraphs-as-presenter-notes: false
slide-dividers: ####
slidecount: true
slidenumbers: true
time-budget: 12

Vous pouvez aussi ajouter des commandes propres à une diapositive avec la syntaxe entre crochets :

[.background-color: #111827]
[.footer: Local footer override]
[.slidenumbers: false]

# Slide title

Certaines commandes sont conservées sous forme de métadonnées, afin de ne pas perdre l’intention du Markdown d’origine, même lorsque Figma n’a pas d’équivalent modifiable direct.

build-lists: notFirst
slide-transition: dissolve(0.4)
time-budget: 12

Pour les transitions entre diapositives, utilisez des valeurs comme dissolve(0.4), fade(0.4), push(left, 0.4), move(right, 0.4) ou reveal(bottom, 0.4). dissolve et fade demandent tous les deux la même transition en fondu.

Séparateurs de diapositives et ancres

Utilisez --- pour séparer les diapositives. Si vous préférez que les titres marquent les changements de diapositive, ajoutez une commande slide-dividers en haut du fichier.

slide-dividers: ####

# First slide

---

#### Second slide

Vous pouvez ajouter des ancres aux titres ou avec des balises d’ancre HTML :

# Closing Summary {#closing-summary}

<a name="pricing-slide"/>

Les liens externes sont importés en liens hypertexte dans le texte Figma. Les liens locaux qui pointent vers une ancre de diapositive importée sont convertis en liens de navigation de prototype Figma, une fois toutes les diapositives créées.

[Visit Hypermatic](https://hypermatic.com)
[Jump to closing](#closing-summary)

Images et médias

Utilisez la syntaxe Markdown habituelle pour les images :

![inline 50%](diagram.png)
![left fit](product-shot.png)
![right alpha(0.6)](panel.png)

Pour les images locales, placez les fichiers référencés dans le même .zip que le fichier Markdown, en respectant leurs chemins :

presentation.zip
  deck.md
  images/hero.png
  diagrams/flow.svg

Référencez ensuite ces fichiers depuis le Markdown :

![inline](images/hero.png)
![inline](diagrams/flow.svg)

Si une image n’est pas incluse dans l’import zippé, utilisez plutôt une URL externe directe :

![inline](https://example.com/images/hero.png)

Modificateurs d’image courants :

• inline pour un contenu intégré à la diapositive.
• left ou right pour les mises en page de diapositive avec image divisée.
• fit ou fill pour la mise à l’échelle de l’image.
• alpha(0.6) pour l’opacité de l’image.
• corner-radius(16) pour arrondir les coins de l’image.
• bn, bw, vivid, noir, chrome, fade, saturation(), blur(), contrast(), brightness(), exposure(), sepia(), vignette() et sharpen() pour des approximations statiques de filtres d’image.

Les lignes ne contenant qu’une image au début d’une diapositive sont traitées comme des images d’arrière-plan. Les images d’arrière-plan SVG sont importées en contenu vectoriel ordinaire plutôt qu’en remplissages d’image Figma.

Les références vidéo et audio sont conservées sous forme de métadonnées de médias Markdown. Si le fichier média peut être résolu, Pitchdeck crée un espace réservé à partir des métadonnées du fichier ; sinon, il crée un espace réservé clairement signalé comme média manquant, afin que l’import puisse continuer.

Diagrammes

Les blocs de code délimités Mermaid et Pikchr sont importés en diagrammes vectoriels pour les types de diagrammes pris en charge.

```mermaid
flowchart LR
  A[Markdown] --> B[Pitchdeck]
  B --> C[Figma]
```

```pikchr
box "Markdown"
arrow right
box "Figma"
```

Les diagrammes Mermaid ou Pikchr plus complexes peuvent être importés sous forme de carte vectorielle de repli affichant leur source, afin que la source du diagramme d’origine reste visible et modifiable après l’import.

Tableaux et notes de bas de page

Les tableaux Markdown sont importés en mises en page de tableau modifiables, à base de texte :

| Left | Center | Right |
| --- | :---: | ---: |
| Plain | _Emphasis_ | **Strong** |

Les notes de bas de page sont regroupées sur les diapositives qui y font référence :

Here is a claim with a footnote.[^source]

[^source]: First footnote line.
  Continuation line for the same footnote.

Notes de l’orateur

Utilisez des lignes qui commencent par ^ pour ajouter des notes de l’orateur à une diapositive :

# Slide title

Visible slide content.

^ This note is saved with the imported slide.

Les notes de l’orateur sont enregistrées sur la diapositive importée, en tant que données de diapositive Pitchdeck et données de plugin propres au Markdown, afin que Pitchdeck puisse les utiliser après l’import.

Limites actuelles

• La syntaxe des formules reste visible sous forme de texte modifiable ; elle n’est pas convertie en rendu mathématique.
• Les commandes d’affichage progressif des listes sont conservées en métadonnées Markdown, mais ne sont pas converties en étapes d’apparition natives des calques Figma.
• Les commandes de transition entre diapositives ne sont que des métadonnées pour les imports dans un fichier de design Figma classique. Lors d’un import dans un fichier Figma Slides, Pitchdeck tente d’appliquer la transition native Figma la plus proche, si l’API Figma le permet.
• Si vous cherchez un effet de « fondu entre les diapositives », utilisez la commande slide-transition ci-dessus dans votre source Markdown, plutôt que de chercher un réglage de diapositive Pitchdeck distinct dans les fichiers de design Figma classiques.
• Les fichiers audio ne sont pas lus directement depuis les frames Figma importés ; les références audio sont conservées sous forme de métadonnées ou d’espaces réservés.
• L’import de médias distants nécessite que l’URL soit directement accessible depuis le plugin.
• Certaines commandes de diagrammes et de filtres d’image sont approximées pour correspondre au comportement Figma disponible le plus proche.

Dépannage

Si l’import semble lent, attendez que l’outil d’import ait fini de préparer les diapositives Markdown. Les fichiers Markdown volumineux contenant de nombreuses images distantes peuvent prendre plus de temps, car le plugin doit résoudre ces ressources avant de pouvoir générer la présentation.

Si une image, une vidéo ou un fichier audio manque après l’import, importez à nouveau le fichier Markdown en incluant les fichiers médias locaux référencés dans le même glisser-déposer.

Si un lien local ne mène pas à une autre diapositive, vérifiez que la diapositive cible a une ancre unique et que le lien utilise le même identifiant d’ancre.

Créer des présentations Markdown avec l’IA

Utilisez l’IA pour rédiger une présentation .md compatible. Vous pouvez demander à des outils d’IA comme OpenAI, Claude ou Gemini de transformer des idées de diapositives, des plans sommaires, des notes de réunion, des transcriptions ou des documents existants en Markdown compatible avec Pitchdeck. Pour de meilleurs résultats, demandez uniquement du Markdown simple, utilisez --- entre les diapositives et des titres # et ##, ajoutez les notes de l’orateur avec ^, et évitez le HTML non pris en charge ou le CSS personnalisé.

Voici quelques exemples de prompts à copier et à adapter :

Turn the notes below into a Pitchdeck-compatible Markdown presentation.

Use Deckset-style syntax with:
- `---` between slides
- `#` for slide titles
- concise bullets
- Markdown tables where useful
- `^` lines for presenter notes

Add these commands at the top of the file:
autoscale: true
fit-header: #, ##
slide-dividers: ---
slidenumbers: true

Output only the final .md file content, with no explanation.

Notes:
[paste your notes here]

Create a 10-slide product demo deck as a Pitchdeck Markdown import file.

Use a strong title slide, problem slide, workflow slide, feature slides, a comparison table slide, and a closing slide.
Use `---` to separate slides, `#` and `##` for headings, and `^` lines for presenter notes.
Add simple per-slide commands like `[.background-color: #f8fafc]` only where they help the design.

Do not use unsupported HTML layouts or custom CSS.
Output only Markdown.

Convert this meeting transcript into an executive summary deck for Pitchdeck.

Keep each slide focused on one idea.
Include slide titles, 3-5 bullets per slide, and presenter notes that summarize what to say.
Use Deckset-style Markdown syntax compatible with Pitchdeck import:
- `---` between slides
- `#` and `##` headings
- Markdown tables where comparison is useful
- `^` lines for presenter notes

Output only the .md file.

Transcript:
[paste your transcript here]

Exemple Markdown pour démarrer

Pour essayer rapidement l’import Markdown, copiez-collez l’exemple ci-dessous dans un nouveau fichier .md, ou téléchargez une présentation de démonstration plus complète :

Télécharger le fichier .md de démonstration de l’import Markdown de Pitchdeck

autoscale: true
background-color: #f8fafc
fit-header: #, ##
footer: Pitchdeck Markdown Import Demo
slide-dividers: ---
slidecount: true
slidenumbers: true

[.background-color: #0f172a]
[.header: #ffffff, alignment(center), text-scale(92)]
[.text: #cbd5e1, alignment(center), text-scale(34)]

# [fit] Markdown to Figma Slides

Turn a plain `.md` deck into editable Pitchdeck slides.

^ This note is saved as a presenter note on the imported slide.

---

# Why Markdown Import?

[.column]
## Write fast

- Draft in any editor
- Keep slides in Git
- Reuse existing Markdown notes

[.column]
## Design later

- Import as editable Figma layers
- Adjust type, layout, and colors
- Export to PPTX when ready

[.end-columns]

---

# One file, many layer types

| Markdown source | Imported result |
| --- | :---: |
| Headings and paragraphs | Editable text |
| Lists and quotes | Structured text |
| Tables | Text-based table layout |
| Presenter notes | Slide notes |

---

[.background-color: #ecfdf5]
[.header: #065f46, alignment(center), text-scale(76)]

# Try it yourself

1. Save this as `pitchdeck-demo.md`.
2. Open Pitchdeck in Figma.
3. Drag the `.md` file into the import dropzone.
4. Edit the imported slides in Figma.

Limites de taille des fichiers

Les fichiers importés peuvent peser jusqu’à 100 Mo avant extraction. Chaque fichier d’une archive peut peser jusqu’à 64 Mo, avec au maximum 10 000 fichiers et 256 Mo de contenu extrait au total, paquets imbriqués compris. Si un import dépasse ces limites, scindez le document ou réduisez la taille de ses images, puis réessayez.