A importação de Markdown está em BETA. Este importador é compatível com a sintaxe do Deckset para arquivos de apresentação em Markdown comuns e funciona melhor quando a sua apresentação usa Markdown padrão mais comandos de apresentação para divisores de slides, fundos, imagens, notas e rodapés.

Importar um arquivo Markdown

Para importar um arquivo de apresentação em Markdown para o Figma, abra o plugin Pitchdeck e arraste um arquivo .md, .markdown ou .zip do seu computador para a área de importação abaixo da lista de slides. Você também pode clicar na área de importação e procurar o arquivo.

Se a sua apresentação foi escrita para o Deckset, você pode importar o mesmo arquivo Markdown diretamente. O Pitchdeck é compatível com a sintaxe do Deckset para divisores de slides, notas do apresentador, imagens, rodapés, números de slide e outros comandos de apresentação compatíveis.

O Pitchdeck cria uma nova página no seu arquivo atual do Figma e adiciona cada slide do Markdown como um frame de slide editável do Figma. A maior parte do conteúdo importado é criada como camadas comuns de texto, imagem, vetor e layout do Figma, então você pode continuar editando a apresentação depois da importação.

Compacte as mídias locais junto com o arquivo Markdown. Se o seu arquivo Markdown faz referência a imagens, SVGs, vídeos ou arquivos de áudio locais, crie um arquivo .zip com um arquivo .md ou .markdown e todos os arquivos de mídia locais que ele referencia. Se você não quiser empacotar arquivos locais, use URLs externas diretas das imagens ou mídias.

Conteúdo Markdown compatível

A importação de Markdown é compatível com o conteúdo de apresentação mais comum e o importa como camadas editáveis do Figma sempre que possível:

• Títulos, parágrafos, citações, código inline, blocos de código e fórmulas como texto editável.
• Negrito, itálico, tachado, sobrescrito, subscrito, links inline e estilos de texto simples com <span style="">.
• Listas não ordenadas, ordenadas, aninhadas e com a numeração da origem.
• Tabelas com alinhamento básico.
• Notas de rodapé, incluindo notas de rodapé nomeadas e com várias linhas.
• Notas do apresentador a partir de linhas ^ note.
• Âncoras e links locais entre slides, incluindo links [Jump](#slide-anchor).
• Imagens inline, imagens de fundo, imagens divididas à esquerda/direita, linhas de imagens, SVGs remotos e espaços reservados para mídias ausentes.
• Referências de vídeo e áudio como metadados de mídia ou espaços reservados.
• Diagramas Mermaid de fluxograma, grafo e pizza como diagramas vetoriais.
• Diagramas Pikchr de caixas/setas como diagramas vetoriais.

Comandos de apresentação

Você pode adicionar comandos no início do arquivo Markdown para controlar a importação inteira:

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

Você também pode adicionar comandos por slide usando a sintaxe de colchetes:

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

# Slide title

Alguns comandos são preservados como metadados para que a intenção original do Markdown não se perca, mesmo quando o Figma não tem um equivalente editável direto.

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

Para as transições de slides, use valores como dissolve(0.4), fade(0.4), push(left, 0.4), move(right, 0.4) ou reveal(bottom, 0.4). Tanto dissolve quanto fade solicitam a mesma transição no estilo dissolver.

Divisores de slides e âncoras

Use --- para separar os slides. Se preferir quebras de slide baseadas em títulos, adicione um comando slide-dividers no início do arquivo.

slide-dividers: ####

# First slide

---

#### Second slide

Você pode adicionar âncoras aos títulos ou com tags de âncora HTML:

# Closing Summary {#closing-summary}

<a name="pricing-slide"/>

Os links externos são importados como hiperlinks de texto do Figma. Os links locais que apontam para a âncora de um slide importado são convertidos em links de navegação de protótipo do Figma depois que todos os slides são criados.

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

Imagens e mídia

Use a sintaxe de imagem comum do Markdown para as imagens:

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

Para imagens locais, mantenha os caminhos dos arquivos referenciados dentro do mesmo .zip do arquivo Markdown:

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

Depois, faça referência a esses arquivos no Markdown:

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

Se uma imagem não estiver incluída na importação compactada, use uma URL externa direta:

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

Os modificadores de imagem mais comuns são:

• inline para conteúdo inline no slide.
• left ou right para layouts de slide com imagem dividida.
• fit ou fill para o dimensionamento da imagem.
• alpha(0.6) para a opacidade da imagem.
• corner-radius(16) para cantos arredondados na imagem.
• bn, bw, vivid, noir, chrome, fade, saturation(), blur(), contrast(), brightness(), exposure(), sepia(), vignette() e sharpen() para aproximações estáticas de filtros de imagem.

As linhas que contêm apenas imagens no início de um slide são tratadas como imagens de fundo. As imagens de fundo SVG são importadas como conteúdo vetorial comum, e não como preenchimentos de imagem do Figma.

As referências de vídeo e áudio são preservadas como metadados de mídia do Markdown. Se o arquivo de mídia puder ser encontrado, o Pitchdeck cria um espaço reservado com os metadados do arquivo; caso contrário, cria um espaço reservado bem visível de mídia ausente para que a importação possa continuar.

Diagramas

Os blocos de código cercados Mermaid e Pikchr são importados como diagramas vetoriais nos tipos de diagrama compatíveis.

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

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

Diagramas Mermaid ou Pikchr mais complexos podem ser importados como um cartão vetorial com o código-fonte, como alternativa, para que o código original do diagrama continue visível e editável depois da importação.

Tabelas e notas de rodapé

As tabelas em Markdown são importadas como layouts de tabela editáveis baseados em texto:

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

As notas de rodapé são reunidas nos slides que fazem referência a elas:

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

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

Notas do apresentador

Use linhas que começam com ^ para adicionar notas do apresentador a um slide:

# Slide title

Visible slide content.

^ This note is saved with the imported slide.

As notas do apresentador são salvas no slide importado como dados de slide do Pitchdeck e dados de plugin específicos do Markdown, para que o Pitchdeck possa usá-las depois da importação.

Limitações atuais

• A sintaxe das fórmulas continua visível como texto editável; ela não é convertida em um diagrama matemático renderizado.
• Os comandos de build-list são preservados como metadados do Markdown, mas não são convertidos em etapas de build nativas das camadas do Figma.
• Os comandos de transição de slides ficam apenas como metadados nas importações para arquivos de design comuns do Figma. Ao importar para um arquivo do Figma Slides, o Pitchdeck tenta aplicar a transição de slides nativa do Figma mais próxima, se a API do Figma permitir.
• Se você procura um efeito de “dissolver entre slides”, use o comando slide-transition acima no seu Markdown de origem, em vez de procurar uma configuração de slide separada do Pitchdeck em arquivos de design comuns do Figma.
• Os arquivos de áudio não tocam diretamente nos frames importados do Figma; as referências de áudio são preservadas como metadados/espaços reservados.
• As importações de mídia remota dependem de a URL estar diretamente acessível pelo plugin.
• Alguns comandos de diagramas e de filtros de imagem são aproximados para corresponder ao comportamento mais próximo disponível no Figma.

Solução de problemas

Se a importação parecer lenta, aguarde o importador terminar de preparar os slides do Markdown. Arquivos Markdown maiores com muitas imagens remotas podem demorar mais, porque o plugin precisa resolver esses assets antes de renderizar a apresentação.

Se faltar uma imagem, um vídeo ou um arquivo de áudio depois da importação, importe o arquivo Markdown de novo e inclua os arquivos de mídia locais referenciados na mesma ação de arrastar e soltar.

Se um link local entre slides não levar a outro slide, confira se o slide de destino tem uma âncora única e se o link usa o mesmo ID de âncora.

Criar apresentações em Markdown com IA

Use IA para rascunhar uma apresentação .md compatível. Você pode pedir a ferramentas de IA como OpenAI, Claude ou Gemini que transformem ideias de slides, roteiros preliminares, anotações de reuniões, transcrições ou documentos existentes em Markdown compatível com o Pitchdeck. Para melhores resultados, peça apenas Markdown simples, use --- entre os slides, use títulos # e ##, adicione notas do apresentador com ^ e evite HTML incompatível ou CSS personalizado.

Aqui estão alguns exemplos de prompts que você pode copiar e adaptar:

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]

Exemplo inicial em Markdown

Para experimentar rapidamente a importação de Markdown, copie e cole o exemplo abaixo em um novo arquivo .md ou baixe uma apresentação de demonstração mais completa:

Baixar o arquivo .md de demonstração da importação de Markdown do 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 tamanho de arquivo

Os arquivos importados podem ter até 100 MB antes da extração. Cada arquivo dentro de um pacote compactado pode ter até 64 MB, com no máximo 10.000 arquivos e 256 MB de conteúdo extraído no total, incluindo pacotes aninhados. Se uma importação passar desses limites, divida o documento ou reduza o tamanho das imagens e tente de novo.