---
url: "/pl/pitchdeck/design/import-markdown.md"
description: "Importuj prezentacje .md i .markdown do Figmy w Pitchdeck: składnia Deckset, edytowalny tekst, obrazy, tabele, notatki prelegenta, stopki, linki do slajdów i polecenia."
---

# Import prezentacji Markdown do Figmy jako edytowalnych slajdów

> Importuj prezentacje .md i .markdown do Figmy w Pitchdeck: składnia Deckset, edytowalny tekst, obrazy, tabele, notatki prelegenta, stopki, linki do slajdów i polecenia.

> **Note:** **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 {#importing-a-markdown-file}

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ę.

> **Tip:** **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 {#supported-markdown-content}

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 ``.
- 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 {#presentation-commands}

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

```markdown
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:

```markdown
[.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.

```markdown
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 {#slide-dividers-and-anchors}

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

```markdown
slide-dividers: ####

# First slide

---

#### Second slide
```

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

```markdown
# Closing Summary {#closing-summary}

```

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.

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

## Obrazy i multimedia {#images-and-media}

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

```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:

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

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

```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:

```markdown
![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 {#diagrams}

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

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

````markdown
```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 {#tables-and-footnotes}

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

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

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

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

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

## Notatki prelegenta {#presenter-notes}

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

```markdown
# 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 {#current-limitations}

- 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 {#troubleshooting}

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 {#creating-markdown-decks-with-ai}

> **Tip:** **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ć:

```text
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]
```

```text
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.
```

```text
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 {#starter-markdown-example}

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

```markdown
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 {#file-size-limits}

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.