Import Markdown jest w wersji BETA. Ten importer obsługuje składnię Deckset typową dla prezentacji w formacie Markdown i działa najlepiej, gdy prezentacja korzysta ze standardowego Markdown oraz poleceń prezentacyjnych do podziału slajdów, teł, obrazów, notatek i stopek.

Import pliku Markdown

Aby zaimportować prezentację Markdown do Figmy, otwórz wtyczkę Pitchdeck i przeciągnij plik .md, .markdown lub .zip z komputera do obszaru importu pod listą slajdów. Możesz też kliknąć obszar importu i wybrać plik.

Jeśli prezentacja została napisana dla Deckset, możesz zaimportować ten sam plik Markdown bezpośrednio. Pitchdeck obsługuje składnię w stylu Deckset dla podziału slajdów, notatek prelegenta, obrazów, stopek, numerów slajdów i innych obsługiwanych poleceń prezentacyjnych.

Pitchdeck utworzy nową stronę w bieżącym pliku Figmy, a potem doda każdy slajd z pliku Markdown jako edytowalną ramkę slajdu w Figmie. Większość importowanej treści powstaje jako zwykłe warstwy tekstowe, obrazy, wektory i warstwy układu w Figmie, więc po imporcie możesz dalej edytować prezentację.

Spakuj lokalne multimedia razem z plikiem Markdown do ZIP. Jeśli plik Markdown odwołuje się do lokalnych obrazów, plików SVG, filmów lub plików audio, utwórz plik .zip, który zawiera jeden plik .md lub .markdown oraz wszystkie lokalne pliki multimedialne, do których się odwołuje. Jeśli nie chcesz pakować plików lokalnych, użyj zamiast tego bezpośrednich zewnętrznych adresów URL obrazów lub multimediów.

Obsługiwana treść Markdown

Import Markdown obsługuje typową treść prezentacji i w miarę możliwości importuje ją jako edytowalne warstwy w Figmie:

• Nagłówki, akapity, cytaty, kod w tekście, bloki kodu i wzory jako edytowalny tekst.
• Pogrubienie, kursywę, przekreślenie, indeks górny i dolny, linki w tekście oraz proste formatowanie tekstu przez <span style="">.
• Listy nienumerowane, numerowane, zagnieżdżone i z numeracją ze źródła.
• Tabele z podstawowym wyrównaniem.
• Przypisy, w tym przypisy nazwane i wielowierszowe.
• Notatki prelegenta z wierszy ^ note.
• Lokalne kotwice i linki do slajdów, w tym linki [Jump](#slide-anchor).
• Obrazy w tekście, obrazy tła, obrazy dzielone lewo/prawo, rzędy obrazów, zdalne pliki SVG i symbole zastępcze brakujących multimediów.
• Odwołania do wideo i audio jako metadane multimediów lub symbole zastępcze.
• Diagramy Mermaid typu flowchart, graph i pie jako diagramy wektorowe.
• Diagramy Pikchr z prostokątami i strzałkami jako diagramy wektorowe.

Polecenia prezentacji

Na początku pliku Markdown możesz dodać polecenia, które sterują całym importem:

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

Możesz też dodawać polecenia dla poszczególnych slajdów w nawiasach kwadratowych:

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

# Slide title

Niektóre polecenia są zachowywane jako metadane, aby nie utracić pierwotnego zamysłu z pliku Markdown, nawet jeśli Figma nie ma bezpośredniego, edytowalnego odpowiednika.

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

Dla przejść między slajdami użyj wartości takich jak dissolve(0.4), fade(0.4), push(left, 0.4), move(right, 0.4) lub reveal(bottom, 0.4). dissolve i fade dają to samo przejście w stylu przenikania.

Podział slajdów i kotwice

Slajdy oddzielaj znakami ---. Jeśli wolisz dzielić slajdy według nagłówków, dodaj na początku pliku polecenie slide-dividers.

slide-dividers: ####

# First slide

---

#### Second slide

Kotwice możesz dodawać do nagłówków albo za pomocą znaczników kotwic HTML:

# Closing Summary {#closing-summary}

<a name="pricing-slide"/>

Linki zewnętrzne są importowane jako hiperłącza w tekście w Figmie. Linki lokalne prowadzące do kotwicy zaimportowanego slajdu są po utworzeniu wszystkich slajdów zamieniane na linki nawigacji prototypu w Figmie.

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

Obrazy i multimedia

Do obrazów używaj zwykłej składni obrazów Markdown:

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

W przypadku obrazów lokalnych umieść pliki, do których prowadzą ścieżki, w tym samym pliku .zip co plik Markdown:

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

Następnie odwołaj się do tych plików w pliku Markdown:

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

Jeśli obrazu nie ma w spakowanym imporcie, użyj zamiast tego bezpośredniego zewnętrznego adresu URL:

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

Typowe modyfikatory obrazów to:

• inline dla treści w obrębie slajdu.
• left lub right dla układów slajdów z obrazem dzielonym.
• fit lub fill dla skalowania obrazu.
• alpha(0.6) dla krycia obrazu.
• corner-radius(16) dla zaokrąglonych narożników obrazu.
• bn, bw, vivid, noir, chrome, fade, saturation(), blur(), contrast(), brightness(), exposure(), sepia(), vignette() i sharpen() dla statycznych przybliżeń filtrów obrazu.

Wiersze zawierające tylko obraz na początku slajdu są traktowane jako obrazy tła. Obrazy tła SVG są importowane jako zwykła treść wektorowa zamiast wypełnień obrazem w Figmie.

Odwołania do wideo i audio są zachowywane jako metadane multimediów Markdown. Jeśli plik multimedialny da się odnaleźć, Pitchdeck tworzy symbol zastępczy na podstawie metadanych pliku; w przeciwnym razie tworzy wyraźny symbol zastępczy brakujących multimediów, aby import mógł być kontynuowany.

Diagramy

Bloki kodu Mermaid i Pikchr są importowane jako diagramy wektorowe w przypadku obsługiwanych typów diagramów.

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

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

Bardziej złożone diagramy Mermaid lub Pikchr mogą zostać zaimportowane zastępczo jako wektorowa karta z kodem źródłowym, dzięki czemu oryginalny kod diagramu pozostaje po imporcie widoczny i edytowalny.

Tabele i przypisy

Tabele Markdown są importowane jako edytowalne układy tabel oparte na tekście:

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

Przypisy są zbierane na slajdach, które się do nich odwołują:

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

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

Notatki prelegenta

Aby dodać do slajdu notatki prelegenta, użyj wierszy zaczynających się od ^:

# Slide title

Visible slide content.

^ This note is saved with the imported slide.

Notatki prelegenta są zapisywane na zaimportowanym slajdzie jako dane slajdu Pitchdeck i dane wtyczki specyficzne dla Markdown, więc Pitchdeck może z nich korzystać po imporcie.

Obecne ograniczenia

• Składnia wzorów pozostaje widoczna jako edytowalny tekst; nie jest zamieniana na wyrenderowany zapis matematyczny.
• Polecenia build-list są zachowywane jako metadane Markdown, ale nie są zamieniane na natywne kroki pojawiania się warstw w Figmie.
• Przy imporcie do zwykłych plików projektowych Figmy polecenia slide-transition są zapisywane wyłącznie jako metadane. Przy imporcie do pliku Figma Slides Pitchdeck próbuje zastosować najbliższe natywne przejście slajdu w Figmie, jeśli API Figmy je obsługuje.
• Jeśli szukasz efektu „przenikania między slajdami”, użyj w źródle Markdown opisanego wyżej polecenia slide-transition, zamiast szukać osobnego ustawienia slajdu w Pitchdeck w zwykłych plikach projektowych Figmy.
• Pliki audio nie odtwarzają się bezpośrednio z zaimportowanych ramek w Figmie; odwołania do audio są zachowywane jako metadane lub symbole zastępcze.
• Import zdalnych multimediów wymaga, aby adres URL był bezpośrednio dostępny z poziomu wtyczki.
• Niektóre polecenia diagramów i filtrów obrazów są przybliżane do najbliższego dostępnego zachowania Figmy.

Rozwiązywanie problemów

Jeśli import wydaje się powolny, poczekaj, aż importer skończy przygotowywać slajdy z pliku Markdown. Większe pliki Markdown z wieloma zdalnymi obrazami mogą potrzebować więcej czasu, bo wtyczka musi pobrać te zasoby, zanim wyrenderuje prezentację.

Jeśli po imporcie brakuje obrazu, filmu lub pliku audio, zaimportuj plik Markdown ponownie i dołącz lokalne pliki multimedialne, do których się odwołuje, w tym samym przeciągnięciu i upuszczeniu.

Jeśli lokalny link do slajdu nie przenosi na inny slajd, sprawdź, czy slajd docelowy ma unikalną kotwicę i czy link używa tego samego identyfikatora kotwicy.

Tworzenie prezentacji Markdown z pomocą AI

Użyj AI, aby przygotować zgodną prezentację .md. Możesz poprosić narzędzia AI, takie jak OpenAI, Claude czy Gemini, aby zamieniły pomysły na slajdy, wstępne konspekty, notatki ze spotkań, transkrypcje lub istniejące dokumenty w Markdown zgodny z Pitchdeck. Najlepsze wyniki osiągniesz, prosząc wyłącznie o zwykły Markdown, ze znakami --- między slajdami, nagłówkami # i ##, notatkami prelegenta dodanymi przez ^ i bez nieobsługiwanego HTML czy własnego CSS.

Oto kilka przykładowych promptów, które możesz skopiować i dostosować:

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]

Przykładowy plik Markdown na start

Jeśli chcesz szybko wypróbować import Markdown, skopiuj i wklej poniższy przykład do nowego pliku .md albo pobierz pełniejszą prezentację demonstracyjną:

Pobierz demonstracyjny plik .md do importu Markdown w 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.

Limity rozmiaru plików

Importowane pliki mogą mieć przed rozpakowaniem maksymalnie 100 MB. Każdy plik w archiwum może mieć do 64 MB, a łącznie archiwum może zawierać do 10 000 plików i 256 MB rozpakowanej treści, wliczając zagnieżdżone pakiety. Jeśli import przekracza te limity, podziel dokument lub zmniejsz rozmiar obrazów, a potem spróbuj ponownie.