Ao exportar uma página do Notion para Markdown, as imagens não são incorporadas diretamente no arquivo .md. Em vez disso, o Notion cria uma referência de imagem Markdown que aponta para um arquivo de imagem separado armazenado em uma pasta adjacente. Esse comportamento costuma surpreender usuários que esperam que as imagens apareçam inline ou sejam anexadas como dados base64. A causa raiz é que a especificação Markdown não suporta dados binários de imagem em arquivos de texto simples. Este artigo explica exatamente como o Notion lida com imagens durante a exportação Markdown, qual é a estrutura de saída e como trabalhar com os arquivos exportados.
Principais Conclusões: Exportação Markdown do Notion e Manipulação de Imagens
- Formato de exportação > Markdown & CSV: O Notion exporta imagens como arquivos separados em uma pasta com o nome da página, não incorporadas no arquivo .md.
- Sintaxe de referência de imagem: O arquivo .md contém
apontando para o arquivo de imagem adjacente. - Tipos de imagem suportados: PNG, JPEG, GIF e WebP são preservados; SVG e HEIC podem ser convertidos ou ignorados.
Por que o Notion Exporta Imagens como Arquivos Separados em Vez de Incorporá-las
O Notion armazena imagens como blobs binários em seu banco de dados na nuvem. Quando você aciona uma exportação Markdown, o Notion não pode incorporar dados binários em um arquivo .md de texto simples porque a especificação Markdown não permite conteúdo binário inline. Em vez disso, o Notion extrai cada imagem como um arquivo separado e escreve uma referência de imagem Markdown no arquivo .md. A referência usa a sintaxe padrão Markdown: um ponto de exclamação, texto alternativo entre colchetes e o nome do arquivo entre parênteses. A pasta exportada conterá o arquivo .md mais uma subpasta com o nome do título da página, que contém todos os arquivos de imagem. O Notion nomeia os arquivos de imagem com um identificador baseado em hash para evitar colisões de nomes. Se a mesma imagem aparecer várias vezes na página, o Notion exporta apenas uma cópia e a referencia de cada local.
O que Determina o Nome do Arquivo de Imagem
O Notion gera o nome do arquivo de imagem a partir de um hash do conteúdo dos dados da imagem. Duas imagens idênticas enviadas separadamente podem produzir hashes diferentes se seus metadados forem diferentes. O padrão de nome geralmente é uma string hexadecimal de 32 caracteres seguida pela extensão do arquivo, por exemplo a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6.png. Esse esquema de nomenclatura evita sobrescritas, mas dificulta a identificação das imagens pelo nome.
Quais Formatos de Imagem São Preservados
O Notion preserva a extensão original do arquivo para formatos comuns: PNG, JPEG, GIF e WebP. Imagens SVG são convertidas para PNG durante a exportação, pois os visualizadores Markdown raramente suportam SVG inline. Imagens HEIC de dispositivos Apple também são convertidas para JPEG. GIFs animados permanecem animados. Se você enviar um TIFF ou BMP, o Notion o converte para JPEG. A conversão ocorre no lado do servidor durante a geração da exportação e você não pode controlar o formato de saída.
Passos para Exportar uma Página do Notion para Markdown e Verificar a Saída de Imagens
- Abra a página que deseja exportar
Navegue até qualquer página em seu espaço de trabalho do Notion que contenha pelo menos uma imagem. A exportação se aplica apenas à página atual, não a todo o espaço de trabalho. - Abra a caixa de diálogo de exportação
Clique no menu de três pontos no canto superior direito da página. Selecione Exportar no menu suspenso. Uma caixa de diálogo aparece com opções de exportação. - Defina o formato de exportação como Markdown & CSV
No menu suspenso Formato de exportação, escolha Markdown & CSV. Se você selecionar HTML ou PDF, o comportamento de manipulação de imagens muda. Para testar a incorporação de imagens, Markdown é a escolha correta. - Configure opções adicionais
Marque Incluir subpáginas se quiser exportar páginas filhas como arquivos .md separados. Deixe desmarcado para exportar apenas a página atual. A opção Criar pasta para cada página está ativada por padrão e é recomendada porque agrupa as imagens de cada página em sua própria pasta. - Clique em Exportar e aguarde o download
O Notion gera um arquivo ZIP contendo o arquivo .md e uma pasta com as imagens. O download começa automaticamente. Se a página tiver muitas imagens grandes, a exportação pode levar vários segundos. - Extraia o arquivo ZIP e inspecione a saída
Descompacte o arquivo. Você verá um arquivo .md e uma pasta com o mesmo nome da página. Abra a pasta para confirmar que todas as imagens da página estão presentes como arquivos separados. Abra o arquivo .md em um editor de texto simples para verificar as referências de imagem.
Problemas Comuns com a Exportação Markdown do Notion e Imagens
Arquivo .md Exportado Mostra Links de Imagem Quebrados
Se você abrir o arquivo .md em um visualizador Markdown que não tem acesso à pasta de imagens adjacente, as imagens aparecerão como links quebrados. A referência de imagem no arquivo .md usa um caminho relativo como . Para corrigir isso, mantenha o arquivo .md e a pasta de imagens no mesmo diretório. Se você mover o arquivo .md para um local diferente, atualize os caminhos das imagens conforme necessário. Alguns editores Markdown permitem definir um caminho base para imagens.
Qualidade da Imagem Diminui Após a Exportação
O Notion não recompacta imagens durante a exportação. A imagem exportada é o arquivo original que você enviou. Se a imagem parecer de qualidade inferior, verifique se o arquivo original foi compactado antes do upload. O Notion aplica sua própria compactação quando você envia imagens pela interface web, mas a exportação preserva a versão compactada. Para manter a qualidade máxima, envie imagens como PNG ou WebP sem compactação prévia.
Imagens Grandes Causam Falha na Exportação
O Notion limita o tamanho total da exportação a 50 MB por página. Se sua página contiver muitas imagens de alta resolução, a exportação pode falhar com um timeout ou arquivo ZIP incompleto. Para contornar isso, reduza as dimensões da imagem antes de enviar ou exporte a página em seções removendo algumas imagens temporariamente. Alternativamente, exporte a página como PDF, que incorpora imagens diretamente no arquivo sem o limite de 50 MB.
Exportação Markdown do Notion vs Exportação HTML: Diferenças no Tratamento de Imagens
| Item | Exportação Markdown | Exportação HTML |
|---|---|---|
| Localização da imagem | Pasta separada | Incorporada como base64 no arquivo .html |
| Tamanho do arquivo | Arquivo .md menor, imagens separadas | Arquivo .html único maior |
| Portabilidade | Deve manter a estrutura de pastas intacta | Arquivo único, sem dependências externas |
| Preservação do formato da imagem | Preserva extensão original para PNG, JPEG, GIF, WebP | Converte todas as imagens para base64, sem alteração de formato |
| Adequação para controle de versão | Boa, imagens são arquivos separados | Ruim, grandes blobs base64 incham os diffs |
A exportação Markdown do Notion mantém as imagens como arquivos separados, o que é ideal para sistemas de controle de versão como Git, pois cada arquivo muda independentemente. A exportação HTML incorpora imagens como dados base64 dentro do arquivo HTML, facilitando o compartilhamento como um único arquivo, mas dificultando o rastreamento de alterações. Escolha Markdown quando planeja editar o conteúdo com um editor de texto ou usar um gerador de site estático. Escolha HTML quando precisar de um arquivo autocontido para visualização offline ou e-mail.