Por que a importação de Markdown no Notion perde níveis específicos de hierarquia de títulos

Ao importar um arquivo Markdown para o Notion, você pode notar que alguns níveis de título não aparecem como esperado. Por exemplo, um H3 no arquivo original pode se tornar texto simples ou se fundir a uma lista com marcadores. Esse problema ocorre porque o Notion mapeia os títulos Markdown para seus próprios tipos de bloco, e o mapeamento não é um para um para todos os seis níveis. Este artigo explica exatamente quais níveis de título são afetados, por que a perda acontece e como preservar a estrutura do documento durante a importação.

Por que o Notion perde a hierarquia de títulos durante a importação Markdown

O Notion suporta três tipos de bloco de título: Título 1, Título 2 e Título 3. Ao importar um arquivo Markdown, o Notion mapeia H1 do Markdown para Título 1 do Notion, H2 para Título 2 e H3 para Título 3. H4, H5 e H6 do Markdown não têm equivalente direto no Notion. Durante a importação, o Notion rebaixa H4 para Título 3, H5 para Título 3 e H6 para Título 3. Esse nivelamento destrói a hierarquia do documento. Se o arquivo Markdown original usa H4 e H5 para denotar subseções abaixo de um H3, cada subseção se torna outro H3, tornando o esboço inútil.

Quais níveis de título são afetados

Os níveis afetados são H4 e H5. H1, H2, H3 e H6 são mapeados corretamente. H6 é mapeado para Título 3 do Notion, mas como H6 é o nível mais profundo, a perda de hierarquia é menos perceptível. H4 e H5 são os níveis mais usados em documentação técnica e escrita estruturada, então sua perda é a mais problemática.

O que acontece com os títulos rebaixados

Quando o Notion rebaixa H4 e H5 para H3, o estilo visual muda. O tamanho da fonte e o peso se tornam idênticos ao H3 mais próximo acima deles. Todas as subseções sob um único H3 pai aparecem como blocos H3 irmãos, em vez de filhos aninhados. Isso quebra as visualizações de esboço e a navegação do sumário no Notion. O documento perde seu significado estrutural.

Etapas para preservar a hierarquia de títulos durante a importação Markdown

A única maneira confiável de preservar a hierarquia de H4 e H5 é modificar o arquivo Markdown antes da importação ou após a importação no Notion. Abaixo estão três métodos. O Método 1 é o mais eficiente para documentos grandes.

Método 1: Converter H4 e H5 para H3 e H6 antes da importação

1. Abra o arquivo Markdown em um editor de texto
   Use o Bloco de Notas, Visual Studio Code ou qualquer editor de texto simples que suporte localizar e substituir. Não use um editor de texto rico como o Word.
2. Substitua títulos H4 por títulos H3
   Pesquise o padrão #### e substitua por ### . Isso converte cada H4 em um H3. A hierarquia será nivelada, mas o texto permanecerá como um bloco de título.
3. Substitua títulos H5 por títulos H6
   Pesquise ##### e substitua por ###### . O Notion mapeia H6 para Título 3, mas o rebaixamento de H5 para H6 preserva um nível de profundidade em comparação com rebaixar H5 diretamente para H3.
4. Salve o arquivo e importe para o Notion
   Use o recurso Importar no Notion: menu Arquivo > Importar > Markdown & CSV. Selecione o arquivo modificado. Agora todos os títulos aparecem como blocos Título 3 do Notion. Você pode ajustar manualmente o nível do título usando o menu de tipo de bloco.

Método 2: Usar blocos de alternância como substitutos de título

1. Importe o arquivo Markdown original
   Importe o arquivo sem nenhuma modificação. Aceite que H4 e H5 se tornarão blocos H3.
2. Converta blocos H3 rebaixados em blocos de alternância
   Selecione um bloco que era originalmente H4 ou H5. Abra o menu de tipo de bloco clicando no ícone de seis pontos à esquerda. Escolha Transformar em > Alternância. O texto do título se torna um cabeçalho de alternância. Você pode aninhar conteúdo abaixo dele.
3. Aplique uma cor ou estilo personalizado à alternância
   Selecione o bloco de alternância, abra o menu de cores e escolha uma cor como Cinza ou Azul. Isso distingue visualmente as alternâncias dos títulos H3 reais. A visualização de esboço ainda mostra apenas H1, H2 e H3, mas a alternância fornece uma hierarquia visível na página.

Método 3: Usar um conversor Markdown de terceiros

1. Abra o arquivo Markdown no Pandoc
   Pandoc é um conversor de documentos de linha de comando. Instale o Pandoc em pandoc.org. Abra um terminal ou prompt de comando.
2. Execute o comando de conversão
   Digite pandoc input.md -f markdown -t markdown --wrap=none -o output.md. Isso reescreve o arquivo Markdown sem alterar os níveis de título. Em seguida, edite manualmente H4 e H5 conforme descrito no Método 1.
3. Importe o arquivo limpo para o Notion
   Use o processo de importação padrão do Notion. O arquivo agora contém apenas títulos H1, H2, H3 e H6, que o Notion mapeia corretamente.

Problemas comuns após a importação Markdown no Notion

Títulos rebaixados aparecem como texto simples em vez de blocos de título

Se o arquivo Markdown usar uma sintaxe de título não padrão (por exemplo, ## Título 2 com um espaço antes do hash), o Notion pode tratar a linha como texto simples. Certifique-se de que o arquivo Markdown use a sintaxe padrão: exatamente um hash para H1, dois para H2 e assim por diante, com um único espaço após os hashes. Remova quaisquer espaços iniciais.

O sumário não mostra todos os títulos

O bloco de sumário do Notion exibe apenas blocos H1, H2 e H3. Os blocos H4 e H5 rebaixados que se tornaram H3 aparecerão, mas sua relação pai-filho original é perdida. Use a solução alternativa do bloco de alternância (Método 2) para restaurar a hierarquia visual, mesmo que o sumário não a reflita.

Títulos dentro de blocos de código não são importados

Títulos Markdown dentro de blocos de código cercados por três crases são tratados como código, não como títulos. O Notion os importa como blocos de código. Se você precisar que esses títulos apareçam como títulos reais, extraia-os do bloco de código antes da importação.

Suporte a blocos de título do Notion vs níveis de título Markdown

Item	Markdown	Notion
Título 1	# Texto	Bloco Título 1
Título 2	## Texto	Bloco Título 2
Título 3	### Texto	Bloco Título 3
Título 4	#### Texto	Rebaixado para Título 3
Título 5	##### Texto	Rebaixado para Título 3
Título 6	###### Texto	Bloco Título 3

O Notion não suporta blocos de Título 4 ou Título 5. A tabela mostra o mapeamento exato durante a importação. Para manter uma hierarquia de quatro níveis, você deve usar a solução alternativa do bloco de alternância ou ajustar manualmente após a importação.