Como salvar uma página do Notion em Markdown (toggles expandidos, databases como tabelas)

A opção nativa “Export as Markdown” do Notion parece uma saída de verdade até você abrir o zip. Os toggles aparecem fechados. Os databases inline saem como HTML quebrado. Os callouts perdem o emoji. Os nomes de arquivo carregam sufixos UUID. Cada link interno aponta para um caminho que não existe mais. E a maioria das ferramentas terceirizadas “Notion to Markdown” só joga fora o HTML renderizado, o que é pior --- você acaba com uma sopa de <div> fingindo ser uma nota.

Este guia cobre todos os métodos para converter uma página do Notion em Markdown limpo --- de uma única página à migração completa de um workspace.

Por que salvar páginas do Notion em Markdown?

Markdown é o formato que sobrevive fora das paredes do Notion:

• Migrar para Obsidian, Logseq ou arquivos planos --- uma pasta, sem Notion blocks proprietários, busca de texto completo em tudo
• Dar para um LLM --- Claude, ChatGPT, Gemini e modelos locais leem Markdown nativamente como contexto
• Escapar do vendor lock-in --- o formato de blocos do Notion é deles, Markdown é seu, o dia em que você decide sair é o dia em que isso importa
• Construir uma base de conhecimento de IA --- aponte Claude Projects ou um pipeline RAG local para uma pasta de Markdown limpo e simplesmente funciona
• Arquivar uma página antes que ela seja reestruturada --- workspaces são reorganizados, páginas são deletadas, suas notas não deveriam depender da faxina de primavera de um colega

O caso de uso que está puxando a maior parte do tráfego Notion-para-Markdown em 2026 é o de migração: pessoas que construíram seu segundo cérebro no Notion em 2020 e agora querem em um formato que realmente controlam.

Método 1: Save (mais rápido, um clique)

Save é uma extensão do Chrome que transforma qualquer página do Notion em um arquivo Markdown com um clique. Ela lê a página renderizada, expande cada toggle, percorre as linhas dos databases e produz algo que realmente parece uma nota --- não um dump dos block IDs do Notion.

Como funciona:

1. Abra a página do Notion no Chrome (páginas do workspace ou links públicos, os dois funcionam)
2. Clique no ícone da extensão Save na sua barra de ferramentas
3. Um arquivo .md é baixado na hora (ou cai no seu Save Vault se estiver conectado)

O que você ganha:

• Toggles totalmente expandidos --- cada seção fechada é aberta e colocada inline, então nada fica escondido
• Databases inline como tabelas Markdown --- as colunas viram cabeçalhos, as linhas viram linhas, as propriedades ficam legíveis
• Databases de página inteira como tabela de linhas --- cada entrada percorrida, propriedades preservadas ao longo da linha
• Callouts como blockquotes estilizados --- o ícone emoji fica no início da citação para que a deixa visual sobreviva ao formato
• Blocos de código com identificadores de linguagem --- ```python, ```ts, ```bash --- o highlight de sintaxe funciona no momento em que você cola em outro lugar
• Referências a páginas linkadas e backlinks --- links internos são preservados como links Markdown para os slugs relevantes
• Título, ícone e capa da página --- o frontmatter captura o título, o ícone e a URL da imagem de capa para que os metadados sobrevivam

O que é removido:

• A sidebar do Notion, o breadcrumb e a nav superior
• O painel de comentários da direita (a menos que você ative explicitamente)
• Botões “Share”, indicador “Updates” e outras tralhas de UI
• Blocos placeholder vazios e os restos “Untitled” padrão do Notion
• Sufixos UUID nos nomes de arquivo --- você ganha product-roadmap-q2.md, não Product-Roadmap-Q2-a1b2c3d4e5f6.md

Melhor para: Qualquer um migrando um workspace do Notion, construindo uma base de conhecimento de IA a partir de docs existentes, ou só tentando pegar uma página sem disparar a fila de export do Notion. Especialmente bom para páginas com uso pesado de toggle e database, que é exatamente onde o export nativo do Notion cai.

Exemplo de saída

Salvar uma página de produto típica do Notion com um toggle e um database inline produz:

---
title: "Product Roadmap Q2 2026"
icon: "🗺️"
cover: "https://www.notion.so/images/page-cover/woodcuts_1.jpg"
url: https://www.notion.so/Product-Roadmap-Q2-2026-a1b2c3d4e5f6
---

# Product Roadmap Q2 2026

## In Progress

### User Authentication Overhaul

- Migrate from JWT to session-based auth
- Add SSO support for enterprise customers
- Timeline: March 15 - April 30

> 💡 **Note:** This blocks the enterprise launch. Prioritize accordingly.

#### Implementation Details

The migration happens in three phases. Phase one ships the new session
store behind a feature flag. Phase two backfills existing JWTs into
sessions on next login. Phase three removes the JWT code path entirely.

```python
session = await create_session(user_id, ttl=86400)
response.set_cookie("sid", session.token, httponly=True)

Planned

API v2

Endpoint	Status	Owner	Target
/users	Spec complete	Alice	Apr 15
/billing	In review	Bob	Apr 22
/analytics	Not started	—	May 06

Related Pages

• Q1 Retrospective
• Auth Migration RFC

Esse arquivo cai no Obsidian como uma nota funcionando. Colado no Claude, dá ao modelo o contexto completo com o conteúdo dos toggles e as linhas do database que o export nativo teria enterrado.

## Método 2: o export Markdown nativo do Notion

O Notion já vem com a opção "Export as Markdown & CSV" no menu da página.

**Passos:**

1. Abra a página, clique no menu `...` no canto superior direito
2. Escolha **Export**, depois o formato **Markdown & CSV**
3. Espere o zip, baixe, descompacte, encontre sua página entre os arquivos com sufixos UUID

**Problemas dessa abordagem:**

- **Os toggles colapsam pra nada** --- o conteúdo dentro dos blocos `▶ Toggle` desaparece por completo do export no code path antigo, ou sai como bloco `<details>` não padrão que a maioria dos editores não renderiza
- **Os databases são divididos em arquivos CSV separados** --- a página em si perde a tabela inline, você fica com um `.md` e um `.csv` irmão que precisa costurar manualmente
- **Os nomes de arquivo têm sufixos UUID** --- `My-Page-a1b2c3d4e5f6.md` --- o que quebra links e fica feio em qualquer file browser
- **Links internos apontam para caminhos UUID** --- `[Other Page](Other-Page-b2c3d4e5f6a1.md)` --- então todo o grafo de links quebra a menos que você reescreva
- **Callouts perdem o estilo** --- o ícone emoji é descartado, o bloco vira um parágrafo comum
- **Imagens de capa e ícones não vão no frontmatter** --- os metadados que você realmente quer somem

Funciona para uma única página só de texto. Cai em qualquer coisa que use os tipos de Notion blocks mais ricos --- que é a maioria das páginas reais.

## Método 3: Notion API + script

Para controle total, você pode puxar a página via a Notion API oficial e converter os blocks para Markdown você mesmo.

```bash
# Using notion-to-md (popular community library)
npm install notion-to-md @notionhq/client

# Set NOTION_TOKEN env var (integration token from notion.so/my-integrations)
node convert.js PAGE_ID > page.md

Melhor para: Times de engenharia rodando exports agendados, construindo um pipeline de sync do Notion para um site de docs, ou qualquer um que precise de controle programático sobre como cada tipo de block mapeia para Markdown.

Problemas dessa abordagem:

• Exige criar uma integração no Notion, dar acesso de página e gerenciar o token
• A biblioteca de conversão (ex. notion-to-md) cuida dos blocks comuns mas fica para trás nos mais novos --- synced blocks, AI blocks e adições recentes muitas vezes saem quebrados
• Propriedades de database (formulas, rollups, relations) precisam de handling custom porque a API as retorna como referências cruas, não como valores resolvidos
• Você está escrevendo e mantendo um conversor, o que é um pedaço de software de verdade
• Rate limits e paginação precisam ser respeitados em workspaces grandes

O método certo se você está construindo um pipeline. Exagero para uma página ou mesmo uma migração pequena.

Método 4: ferramentas de migração de terceiros (Loom, super.so, etc.)

Um pequeno ecossistema de ferramentas pagas mira especificamente a migração do Notion --- algumas focam em mover para um destino específico (Obsidian, Roam), outras publicam páginas do Notion na web (super.so, Potion).

Melhor para: Times fazendo uma migração em massa one-shot que querem um serviço para lidar com a long tail de tipos de blocks e não se importam de pagar por workspace.

Problemas para o caso de uso Markdown:

• A saída geralmente está amarrada a um destino específico (vault do Obsidian, grafo do Roam) em vez de Markdown portátil e limpo
• A maioria são serviços pagos com taxas por workspace ou por página
• A qualidade varia muito --- algumas ferramentas só chamam o export do Notion por baixo dos panos, então você herda todos os problemas dele com passos extras
• Tempo lento em workspaces grandes porque elas fazem batch das operações
• Projetadas para migração única, não para uso ad-hoc “salva essa página agora”

Se está movendo um workspace inteiro e não quer tocar em script, avalie uma dessas. Se quer uma página limpa em cinco segundos, são a ferramenta errada.

Qual método você deve usar?

Cenário	Melhor método
Colar uma página do Notion no Claude ou ChatGPT	Save --- um clique, toggles expandidos
Migrar uma página para o Obsidian	Save --- nome limpo, links funcionando
Construir uma base de conhecimento de IA a partir do workspace	Save --- Markdown consistente entre páginas
Arquivar uma página antes que um colega reorganize	Save --- captura o que você vê agora
Exportar em massa um workspace inteiro, one-shot	Export nativo do Notion --- aceite o imposto de limpeza
Construir um pipeline automatizado Notion → site de docs	Notion API + script --- programático e estável
Pagar um serviço para fazer a migração por você	Ferramenta de terceiros --- se a qualidade segurar

Para a maioria das pessoas --- especialmente quem usa conteúdo do Notion como contexto de IA ou migra para uma ferramenta Markdown-nativa --- Save é a resposta. Produz o Markdown mais limpo com zero setup, e cuida de páginas pesadas em toggle e database sem nenhuma das perdas estruturais que o export nativo impõe.

Casos limítrofes que o Save resolve

• Databases aninhados dentro de páginas. Uma página com um database, onde uma das linhas linka para outra página que por sua vez contém um database --- Save expande a tabela de nível superior e linka para as páginas aninhadas, não tenta colocar o mundo inteiro inline. A recursão é opt-in para o caso raro em que você quer a árvore toda.
• Sub-páginas e páginas linkadas. Links internos são preservados como links Markdown. Se você salva o pai e os filhos separadamente, os links resolvem. Se salva só o pai, os links ficam como referências que você pode resolver depois.
• Synced blocks. Resolvidos para o conteúdo real. O Markdown contém o texto resolvido, não um placeholder apontando para o block fonte.
• Comentários. Desligado por padrão. Ligue nas configurações da extensão se quiser capturar o thread de discussão junto com o conteúdo da página (útil para arquivo, barulhento para contexto de IA).
• Templates e template buttons. O conteúdo do template é capturado como aparece renderizado. Template buttons em si são descartados já que são elementos interativos sem representação estática.
• Wiki pages e gallery views. Páginas iniciais de wiki mantêm sua lista de páginas filhas. Gallery views viram uma tabela de entradas com as propriedades visíveis como colunas.
• Propriedades de database (formulas, rollups, relations). Valores de formula e rollup são capturados como o texto renderizado. Relations são preservadas como links Markdown para as páginas relacionadas.
• Páginas públicas vs privadas. Save vê o que seu browser logado vê. Se você pode ler a página, Save pode converter --- funciona igual em páginas do workspace, páginas compartilhadas e links públicos.
• Páginas longas com centenas de blocks. A extensão divide a conversão em chunks para que o browser não congele. A saída é um único arquivo Markdown contínuo independente do tamanho da página.

Combine com seu workflow

A saída em Markdown funciona onde você precisar:

• Obsidian --- jogue o arquivo no seu vault, o grafo de links se reconstrói automaticamente conforme você salva mais páginas
• Logseq --- mesma história, propriedades de página viram propriedades do Logseq
• Claude / ChatGPT / Gemini --- cole o arquivo, faça perguntas de follow-up, use como contexto de um Project
• Apple Notes --- import limpo via a extensão de compartilhamento de Markdown
• Pasta plana + ripgrep --- se você foi minimalista, uma pasta de Markdown mais rg é uma busca mais rápida do que o Notion jamais foi
• Save Vault --- se você conectou um, cada save do Notion cai lá automaticamente com backlinks e tags, então o workspace inteiro vira buscável conforme migra

FAQ

Save funciona em páginas privadas de workspace? Sim. Save roda no seu browser logado, então qualquer coisa que você consiga ler --- páginas de workspace, páginas compartilhadas, links públicos --- Save consegue converter.

Save vai estragar meus dados no Notion? Não. Save é somente leitura. Lê a página renderizada na aba do seu browser e escreve um arquivo Markdown no seu computador. Nunca modifica o Notion, nunca chama a Notion API, nunca toca no seu workspace.

E sobre imagens e anexos? Imagens são referenciadas como links de imagem Markdown apontando para as URLs S3 do Notion. Essas URLs são assinadas e expiram, então para arquivamento de longo prazo, combine Save com uma passada “embed images locally” --- peça à extensão para baixar as imagens junto com o Markdown.

Ele preserva os toggles? Sim, e esse é o principal diferencial em relação ao export nativo do Notion. Cada toggle na página é aberto e seu conteúdo é colocado inline. Você vê tudo que está realmente na página, não só os títulos.

Posso exportar em massa um workspace inteiro? A extensão é uma-página-por-vez hoje. Para migração de workspace completo, o workflow que a maioria usa é: salve a wiki page de topo do workspace (que captura a árvore de páginas), depois salve as páginas que você realmente quer uma a uma. Mais rápido do que parece porque cada save é um clique.

Funciona no Notion mobile? Só Chrome desktop. No mobile, copie a URL e abra no desktop, ou use o handler de URL do Save Vault no Mac.

Como se compara ao notion-to-md e outros scripts? A qualidade da saída é comparável em páginas simples. Em páginas com toggles, callouts e databases inline, a saída do Save é mais limpa porque ele lê o DOM renderizado em vez de andar pela árvore de blocks crua --- o que significa que novos tipos de blocks simplesmente funcionam sem esperar por uma atualização da biblioteca.

Quanto custa? Save tem um tier gratuito para você testar em algumas páginas. Depois disso, uma assinatura pequena cobre os custos de conversão.

Guias Save relacionados

• Salvar Google Docs como Markdown --- comentários, sugestões e formatação preservados
• Exportar Confluence para Markdown --- o equivalente wiki corporativo, com a mesma dor de migração
• Salvar conversas do ChatGPT como Markdown --- cada turno, com blocos de código intactos
• Salvar vídeos do YouTube como Markdown --- transcript, resumo, timestamps, prontos para o Claude