Como escrever um arquivo Markdown que se importa para o JW Library
Escreva uma nota no Bloco de Notas, no TextEdit ou no Obsidian e faça com que ela caia no versículo certo do JW Library. As linhas exatas a digitar, e tudo o que dá para omitir.
O JW Sync consegue ler arquivos Markdown para dentro de um backup do JW Library, o que levanta a única pergunta que realmente importa depois que você sabe que o recurso existe: como o arquivo deve ser? Esta página responde isso pelo lado de quem escreve — não o que o importador aceita, mas o que você de fato digita.
A versão curta é que uma nota é um arquivo de texto. Crie o arquivo, escreva a nota, salve com .md no final e ele será importado. Todo o resto aqui é sobre uma única linha opcional: a que diz a qual passagem a nota pertence, para que ela apareça no JW Library enquanto você lê aquele versículo em vez de ficar solta entre as suas outras notas.
Nada disso exige um editor de Markdown, e nada exige que você aprenda Markdown. O Bloco de Notas no Windows e o TextEdit no Mac bastam. Se você já guarda suas notas de estudo no Obsidian ou no Notion, esses arquivos já são Markdown, e há uma seção para cada um mais abaixo.
Passo a passo
Abra qualquer editor de texto simples
Bloco de Notas no Windows, TextEdit no Mac, ou o aplicativo de Markdown que você já usa — Obsidian, Typora, iA Writer, Joplin. A única coisa a evitar é um processador de texto: o Word e o Google Docs salvam formatação e diagramação em vez de texto simples, e nenhum dos dois produz um arquivo que o importador consiga ler.
Digite a nota
Coloque o título na primeira linha com um # na frente, deixe uma linha em branco e escreva a nota embaixo. Isso já é um arquivo completo e válido. Se você preferir não escrever nenhuma linha de título, o nome do arquivo é usado no lugar.
Salve com .md no final
Chame do que quiser: minha nota.md. No Windows, o Bloco de Notas salva um .txt a menos que você antes mude «Tipo» para «Todos os arquivos», que é o erro mais comum. No Mac, escolha Formatar e depois Converter para texto simples antes de salvar.
Acrescente a linha que coloca a nota num versículo
Bem no topo do arquivo, acima de tudo, escreva uma linha com três traços, depois publication: Matthew 26:39, e depois mais três traços. A nota já está ligada àquele versículo. Se deixar isso de fora, a nota ainda assim é importada — ela apenas chega desvinculada.
Importe para um backup
No JW Library, vá em Estudo pessoal, abra o menu de três pontos, escolha Backup e restauração e crie um backup. Carregue esse arquivo em jwsync.org, no Explorador de estudo, toque em «Importar Markdown», escolha seus arquivos .md e leia o resumo que aparece antes de qualquer coisa ser escrita. Depois toque em «Exportar .jwlibrary» e restaure esse arquivo no JW Library.
O menor arquivo que funciona
Um arquivo que não tem nada além de texto já é uma nota válida. É isto:
# O cálice pelo qual ele orou A oração dele mostra submissão, não relutância.
A linha que começa com # vira o título da nota, e tudo o que está abaixo dela vira a nota. Esse arquivo é importado sem reclamação. Ele apenas chega como uma nota avulsa, no meio das suas notas em vez de ligada a uma passagem.
Criar o arquivo no Windows
Abra o Bloco de Notas, digite a nota e escolha Arquivo e Salvar como. Antes de salvar, mude «Tipo» de «Documentos de texto» para «Todos os arquivos» — sem esse passo o Bloco de Notas acrescenta .txt por conta própria e você acaba com minha nota.md.txt, que o importador não vai enxergar. Depois digite o nome terminando em .md. O Windows pode avisar que mudar a extensão pode tornar o arquivo inutilizável; esse aviso é o sinal de que você fez certo.
Criar o arquivo num Mac
Abra o TextEdit e escolha Formatar e depois Converter para texto simples antes de digitar qualquer coisa. O TextEdit começa em modo de texto formatado e salva .rtf, que não é um arquivo de texto de jeito nenhum. Já em modo de texto simples, escolha Arquivo e Salvar, e termine o nome com .md. Se o macOS se oferecer para acrescentar o .txt, recuse.
Criar o arquivo no celular ou no tablet
Serve qualquer aplicativo capaz de salvar ou exportar Markdown — Obsidian, Bear, iA Writer, Joplin, Markor no Android. Os aplicativos de notas que já vêm no iPhone e no Android geralmente não conseguem salvar um arquivo .md, então no celular o caminho normal é um desses aplicativos, ou simplesmente escrever num computador. Na hora de importar você pode selecionar quantos arquivos quiser de uma vez, e uma pasta inteira pode ser compactada e entregue como um único .zip.
A única linha que coloca uma nota num versículo
Tudo o que diz ao importador onde a nota vai fica num pequeno bloco bem no topo do arquivo, entre duas linhas de três traços. Isso se chama front matter, e para a maioria das notas tem uma linha só:
--- publication: Matthew 26:39 --- # O cálice pelo qual ele orou A oração dele mostra submissão, não relutância.
Essa nota agora está ligada a Mateus 26:39. Ela aparece no JW Library enquanto você lê aquele versículo, exatamente como se você a tivesse escrito ali pelo aplicativo.
Como escrever a referência para que seja entendida
Escreva o nome do livro em inglês, mesmo que a nota esteja em outro idioma: Matthew, não Mateus. As abreviações que as pessoas realmente digitam também são entendidas — Matt, Matt., Mt, 1 Cor, 1Cor, I Corinthians, Second Timothy. Entre o capítulo e o versículo você pode usar dois-pontos, um ponto ou a letra v, então John 3:16, John 3.16 e 1 Cor 13 v4 significam a mesma coisa, e os espaços são opcionais, de modo que 1Cor13:4 também serve. Um intervalo como Matthew 26:39-41 coloca a nota no primeiro versículo, o 39, porque uma nota do JW Library se prende a um ponto do texto e não a um trecho.
O arquivo completo, com título, data e tags
Há mais três linhas disponíveis, se você quiser, e todas são opcionais:
--- title: O cálice pelo qual ele orou date: 2026-08-15 tags: [estudo, getsêmani] publication: Matthew 26:39 --- A oração dele mostra submissão, não relutância.
title faz o mesmo que o cabeçalho com #, então basta um dos dois. date define a data da nota em vez de deixar o dia em que você importou. tags viram tags de verdade no JW Library, pelas quais você pode filtrar, e uma tag que você já tem é reaproveitada em vez de duplicada. A linha de tags também pode ser escrita estudo, getsêmani sem colchetes, ou #estudo #getsêmani, ou como uma lista com traços em linhas separadas embaixo — as quatro formas são lidas do mesmo jeito.
Uma nota por arquivo
Cada arquivo .md vira uma nota. Não há como colocar várias notas num mesmo arquivo e fazer com que se separem, porque nada num arquivo Markdown marca de forma confiável onde uma nota termina e a próxima começa — um cabeçalho no meio pode ser uma segunda nota ou pode ser um subtítulo da primeira, e errar espalharia o que você escreveu. Então escreva um arquivo por nota e selecione todos de uma vez na hora de importar, ou compacte a pasta e escolha o .zip.
A formatação que chega inteira
Parágrafos, quebras de linha, negrito, itálico e listas com marcadores chegam ao JW Library como formatação de verdade. Cabeçalhos depois do primeiro viram parágrafos comuns. Tudo o que o Markdown consegue expressar e uma nota do JW Library não — tabelas, imagens, links, blocos de código — é reduzido ao seu texto, de modo que as palavras sobrevivem mesmo onde a diagramação não consegue acompanhar.
Se você já escreve no Obsidian
Os arquivos do Obsidian já são Markdown, e o painel de propriedades dele escreve exatamente o front matter descrito aqui: acrescente uma propriedade chamada publication com o valor Matthew 26:39 e a nota vai parar lá. A propriedade tags do próprio Obsidian é lida como tags. Links entre colchetes duplos e notas embutidas são reduzidos ao seu texto, já que uma nota do JW Library não tem para onde apontá-los. Você pode selecionar os .md de uma pasta inteira numa única importação, ou compactar a pasta e entregar o .zip.
Se você já escreve no Notion
O Notion consegue exportar Markdown: abra o menu da página, escolha Exportar e selecione «Markdown & CSV». O que sai é um .zip, que o importador aceita como está. O Notion escreve o título da página como cabeçalho e as próprias propriedades como linhas comuns embaixo, e os campos que o importador não reconhece são ignorados em vez de tratados como erro — então, para colocar uma nota num versículo, acrescente você mesmo uma linha publication no topo do arquivo exportado.
Coisas que você não precisa acertar
Maiúsculas nos nomes dos campos não fazem diferença. O espaço depois dos dois-pontos pode faltar. Espaços e tabulações a mais são ignorados, assim como aspas em volta de um valor e um comentário escrito depois de um #. Quebras de linha do Windows não são problema. Você pode até deixar as linhas --- de fora e começar o arquivo direto pelos campos, desde que a primeiríssima linha seja um deles. E se você escrever o nome de um livro errado — Mathew —, o importador avisa que leu aquilo como Matthew 26:39 e espera você marcar a caixinha, em vez de decidir sozinho.
O que a importação não vai fazer com a sua biblioteca
Importar só acrescenta. As notas, os destaques, os marcadores e as tags que já estão no seu backup não são tocados, e o arquivo que você carrega nunca é modificado — no final você baixa um .jwlibrary novo e restaura esse. Uma nota cujo título, texto e lugar coincidam com algo que já está no backup é pulada, então importar os mesmos arquivos duas vezes não duplica nada. Tudo o que uma importação acrescenta é um único passo de Desfazer, e as notas importadas levam uma tag Imported, de modo que depois você pode encontrá-las, filtrá-las ou removê-las como grupo. Nada disso sai do seu dispositivo.
Perguntas frequentes
- Preciso aprender Markdown antes?
- Não. Um arquivo com frases comuns já é uma nota válida. O Markdown só entra em jogo se você quiser negrito, itálico ou marcadores, e mesmo assim é pôr dois asteriscos em volta de uma palavra para o negrito e um traço no começo da linha para um marcador.
- O nome do arquivo importa?
- Só quando o arquivo não tem título próprio. Se não houver linha title: nem cabeçalho com #, o nome do arquivo é ajeitado e usado no lugar, então o-calice-pelo-qual-ele-orou.md vira uma nota chamada «o calice pelo qual ele orou». Fora isso, chame o arquivo do que quiser.
- E se eu tiver salvado como .txt sem querer?
- Renomeie para terminar em .md e importe de novo — não é preciso mudar nada do conteúdo. No Windows talvez você precise antes ativar as extensões de nome de arquivo no menu Exibir do Explorador, ou a terminação fica escondida.
- Posso escrever o nome do livro no meu idioma?
- Por enquanto não. Os nomes dos livros são reconhecidos em inglês, que é também o que a exportação de Markdown deste site escreve. Escreva a nota no idioma que quiser; só a linha da referência precisa do nome em inglês. Se preferir, deixe a referência de fora e posicione a nota à mão depois.
- Posso pôr mais de uma nota num único arquivo?
- Não — cada arquivo vira uma nota. Selecione quantos arquivos quiser numa importação, ou compacte a pasta e escolha o .zip.
- Isso vai mudar as notas que eu já tenho?
- Não. Importar só acrescenta. Suas notas atuais não são tocadas, e o backup que você carrega nunca é modificado: no final você baixa um arquivo novo e decide se restaura.
- O que acontece se eu deixar a linha da referência de fora?
- A nota é importada do mesmo jeito. Ela chega como uma nota avulsa na sua biblioteca em vez de ligada a uma passagem — que é justamente o que uma nota sobre um discurso, uma conversa ou uma reflexão pessoal costuma querer.