Importar PDFs para um cofre do Obsidian sem fazer bagunça

Decida o que é a nota antes de converter

Um manual de 90 páginas convertido numa única nota é tecnicamente pesquisável e praticamente inútil: longo demais para ler num painel, longo demais para linkar com precisão, e vai dominar todos os resultados de busca em que aparecer.

Antes de converter, decida se o PDF é uma nota ou várias. Um artigo é uma nota. Um manual é uma nota por capítulo. Um livro é uma nota por capítulo com uma nota índice ligando-as. Divida o PDF antes e converta os pedaços — dá bem menos trabalho do que dividir o Markdown depois, porque no PDF você enxerga os limites de página.

A escada de títulos é a espinha da nota

O painel de sumário do Obsidian, o recolhimento, os links por nível de título e boa parte da ordenação da busca derivam todos da estrutura de títulos. Uma nota com títulos errados é uma nota com navegação errada.

É aqui que arquivos convertidos mais costumam precisar de trabalho, porque os níveis de título vêm dos tamanhos de fonte e os tamanhos de fonte são só aproximadamente consistentes dentro de um documento. Dois minutos ajustando a escada se pagam na primeira vez que você usar o painel de sumário.

Uma convenção que vale adotar: deixe o título da nota carregar o nome do documento e comece o corpo em H2, em vez de abrir com um H1 que repete o nome do arquivo. O Obsidian já mostra o nome do arquivo como título, então um H1 que o duplica desperdiça o topo de cada nota.

Front matter que se justifica

O Obsidian lê o front matter em YAML como propriedades, que alimentam consultas do Dataview, o painel de propriedades e os filtros de busca. Um conversor não consegue gerá-lo — nada disso está no PDF — então vale acrescentá-lo à mão, uma vez, na importação.

Restrinja-se a campos que você vai realmente consultar. Front matter que ninguém filtra é só ruído no topo de cada nota.

---
title: Manual de sistemas distribuídos, cap. 4
source: manual-sistemas-distribuidos.pdf
author: R. Mehta
year: 2023
pages: 61-84
tags: [referencia, sistemas-distribuidos]
imported: 2026-08-04
---

Guarde o PDF original e crie um link para ele

A conversão perde coisas: figuras não sobrevivem, e nada composto como imagem também. Guarde o PDF de origem no cofre, numa pasta de anexos, e crie um link para ele a partir da nota.

Isso dá o arranjo útil: o Markdown é o que você busca, linka, cita e anota; o PDF é o que você abre quando precisa da figura da página 12 ou conferir um número contra o original.

> Convertido de [[anexos/manual-sistemas-distribuidos.pdf]].
> Figuras e diagramas estão no original.

Faça a passada de links enquanto o documento está fresco

Uma nota convertida chega sem links, o que significa que chega invisível para o grafo e inalcançável de qualquer outro ponto do cofre. O valor dela sobe enormemente com uns cinco minutos de trabalho.

Leia a nota uma vez e envolva em colchetes duplos os termos que já existem como notas. Onde um conceito merecer uma nota que ainda não existe, crie o link mesmo assim — um link não resolvido é uma pendência que aparece no grafo, que é exatamente onde você quer que ela apareça.

Depois acrescente a nota ao índice ou mapa de conteúdo que cobre o assunto dela. Uma nota que nada aponta não será reencontrada, por melhor que seja o conteúdo.

Converter um acúmulo

Se você está importando uma pasta de PDFs em vez de um documento só, faça por passadas sobre o conjunto inteiro em vez de terminar cada nota por completo antes de começar a próxima. Converta tudo primeiro, depois ajuste todas as escadas de títulos, depois acrescente todo o front matter, e por último faça os links.

É mais rápido e produz um cofre consistente: as notas que você fez por último se parecem com as que fez primeiro, o que não acontece quando você melhora suas convenções nota a nota.

O que não vale o esforço

• Não tente preservar na nota os números de página do PDF. O Markdown não pagina, então eles não se referem a nada.
• Não converta PDFs digitalizados sem reconhecer o texto antes — você vai obter uma nota vazia e ficar sem entender.
• Não converta um PDF do qual você tem o documento original. Converta o original: ele tem estrutura de verdade, e nada precisa ser inferido.
• Não gaste tempo reconstruindo tabelas complexas em Markdown. Tire uma captura da tabela, guarde o link do PDF e siga em frente.