Ao importar um arquivo Markdown para o Notion, os níveis de cabeçalho do documento original nem sempre são mapeados diretamente para os estilos de cabeçalho do Notion. Você pode descobrir que um H1 no Markdown se torna o título da página, enquanto H2 e H3 viram cabeçalhos de alternância ou texto simples. Essa incompatibilidade pode quebrar a estrutura das suas anotações, especialmente se você depende de um esboço consistente. O Notion usa seu próprio sistema de cabeçalhos baseado em blocos com três níveis: Título 1, Título 2 e Título 3. Este artigo explica exatamente como cada nível de cabeçalho do Markdown é mapeado para os cabeçalhos do Notion e como controlar o resultado durante a importação.
Principais Conclusões: Mapeamento de Cabeçalhos do Markdown para o Notion
- Markdown H1 vira título da página: O primeiro H1 do arquivo é convertido no nome da página, não em um bloco de Título 1.
- Markdown H2 mapeia para Título 1 do Notion: Todas as linhas H2 se tornam blocos de Título 1 no corpo da página.
- Markdown H3 mapeia para Título 2 do Notion: Todas as linhas H3 se tornam blocos de Título 2.
- Markdown H4–H6 mapeiam para Título 3 do Notion: Todas as linhas H4, H5 e H6 se tornam blocos de Título 3.
- Sem aninhamento automático: O Notion não cria subpáginas ou alternâncias aninhadas a partir dos níveis de cabeçalho.
Como o Notion Interpreta os Níveis de Cabeçalho do Markdown
O mecanismo de importação do Notion lê arquivos Markdown linha por linha. Ele detecta cabeçalhos pelo caractere hash (#) no início de uma linha. O número de hashes determina o nível do cabeçalho na especificação original do Markdown. No entanto, o Notion não preserva o nível exato. Em vez disso, ele aplica uma regra de deslocamento para se ajustar ao seu próprio sistema de cabeçalhos de três níveis.
A causa raiz da confusão é que o Notion trata o primeiro H1 como título da página. Isso ocorre porque as páginas do Notion têm um título único no topo, não um cabeçalho dentro do conteúdo. Depois disso, cada nível de cabeçalho é deslocado um nível para baixo. H2 se torna o cabeçalho de bloco mais alto (Título 1), H3 se torna Título 2, e H4 a H6 são todos colapsados em Título 3. Esse mapeamento não é configurável na caixa de diálogo de importação padrão. Você não pode optar por manter H1 como um bloco de Título 1 ou mapear H4 para um estilo separado.
O Notion também ignora qualquer indentação ou aninhamento implícito pelos níveis de cabeçalho. Um documento Markdown com H2 seguido de H3 e H4 não cria um esboço recolhível. Cada bloco de cabeçalho fica no mesmo nível hierárquico da página. Para criar estruturas aninhadas, você deve usar blocos de alternância ou subpáginas manualmente após a importação.
Passos para Importar um Arquivo Markdown e Verificar o Mapeamento de Cabeçalhos
- Prepare seu arquivo Markdown
Certifique-se de que seu arquivo use a sintaxe padrão de cabeçalho do Markdown. Use um único H1 no topo para o título da página. Use H2 para seções principais, H3 para subseções e H4–H6 para níveis mais profundos. Salve o arquivo com extensão .md. - Abra o Notion e crie uma nova página
Clique no botão + Nova página na barra lateral esquerda. Dê qualquer nome à página. Você substituirá esse nome durante a importação. - Inicie o processo de importação
Clique no menu de três pontos no canto superior direito da nova página. Selecione Importar no menu suspenso. Escolha Markdown e CSV na lista de tipos de arquivo. - Selecione seu arquivo Markdown
Clique em Escolher arquivo e navegue até seu arquivo .md. O Notion suporta arquivos de até 5 MB. Se seu arquivo for maior, divida-o em vários arquivos. - Revise os cabeçalhos importados
Após a importação, role a página. O primeiro H1 do seu arquivo aparece como título da página. Verifique cada bloco de cabeçalho no corpo. Linhas H2 devem ser blocos de Título 1 (texto grande e negrito). Linhas H3 devem ser blocos de Título 2 (texto médio e negrito). Linhas H4–H6 devem ser blocos de Título 3 (texto pequeno e negrito). - Ajuste manualmente qualquer cabeçalho desalinhado
Se um cabeçalho aparecer no nível errado, clique no ícone de seis pontos à esquerda do bloco. Selecione Transformar em e escolha o nível de cabeçalho correto. Por exemplo, se um H2 se tornou Título 1 mas você deseja que seja Título 2, use este menu para alterá-lo.
Problemas Comuns na Importação e Como Corrigi-los
Primeiro H1 aparece como bloco de Título 1 em vez de título da página
Isso acontece quando o arquivo Markdown tem texto ou linhas em branco antes do primeiro H1. O Notion lê o primeiro elemento em nível de bloco como título da página. Se o arquivo começar com um parágrafo, esse parágrafo se torna o título. Para corrigir, edite o arquivo Markdown para que a primeira linha seja o cabeçalho H1. Remova quaisquer linhas em branco ou texto acima dele.
Múltiplos cabeçalhos H1 no mesmo arquivo
O Notion usa apenas o primeiro H1 como título da página. Todas as linhas H1 subsequentes se tornam blocos de Título 1 no corpo. Isso pode quebrar a hierarquia pretendida. Para evitar, use apenas um H1 por arquivo. Converta linhas H1 adicionais para H2 antes de importar.
Cabeçalhos perdem formatação como negrito ou itálico
O Notion não suporta formatação inline dentro de blocos de cabeçalho durante a importação. Se seu cabeçalho Markdown contiver texto em negrito ou itálico, a formatação é perdida. Após a importação, reaplique a formatação manualmente ao texto do cabeçalho.
Níveis de cabeçalho deslocados incorretamente
Se você esperava que H1 se tornasse Título 1 e H2 se tornasse Título 2, a importação parecerá errada. Isso não é um bug. O mapeamento do Notion é fixo. Para alcançar a hierarquia original, edite o arquivo Markdown antes da importação. Rebaixe todos os cabeçalhos em um nível. Por exemplo, altere H1 para H2, H2 para H3 e H3 para H4. Depois da importação, promova o título da página manualmente.
Níveis de Cabeçalho do Notion vs Níveis de Cabeçalho do Markdown
| Item | Sintaxe Markdown | Resultado da Importação no Notion |
|---|---|---|
| Título da página | Primeiro H1 (# Título) | Nome da página na área do cabeçalho |
| Cabeçalho de bloco mais alto | H2 (## Seção) | Bloco de Título 1 (grande, negrito) |
| Segundo cabeçalho de bloco | H3 (### Subseção) | Bloco de Título 2 (médio, negrito) |
| Cabeçalho de bloco mais baixo | H4–H6 (#### a ######) | Bloco de Título 3 (pequeno, negrito) |
| Formatação inline no cabeçalho | negrito ou itálico | Texto simples (formatação perdida) |
Esta tabela mostra o mapeamento exato que você pode esperar. Use-a para planejar a estrutura do seu arquivo Markdown antes de importar para o Notion.
Agora você sabe como o Notion mapeia os níveis de cabeçalho do Markdown para seus próprios cabeçalhos de bloco. A regra principal é que H1 se torna o título da página, H2 se torna Título 1, H3 se torna Título 2 e H4 a H6 se tornam Título 3. Para obter a estrutura desejada, edite seu arquivo Markdown antes da importação, rebaixando todos os cabeçalhos em um nível. Se precisar de aninhamento mais profundo, use blocos de alternância ou subpáginas após a importação. Um próximo passo prático é testar esse mapeamento com um pequeno arquivo Markdown contendo dois cabeçalhos H2 e três subcabeçalhos H3 para ver o resultado em primeira mão.