Como importar notas em Markdown para o JW Library
Transforme arquivos .md do Obsidian, do Notion ou de qualquer editor de Markdown em notas reais do JW Library, colocadas no versículo certo — grátis, privado, no seu navegador.
O JW Library não tem nenhuma forma de trazer texto para dentro. Você pode escrever notas dentro do aplicativo, mas uma nota escrita em outro lugar — no Obsidian, no Notion, num arquivo de texto do computador — não tem caminho nenhum até a sua biblioteca. As pessoas acabam redigitando tudo, ou desistem e ficam com dois conjuntos de notas de estudo que nunca se encontram.
O JW Sync fecha essa lacuna. Carregue um backup no Explorador de estudo, toque em “Importar Markdown” e seus arquivos .md viram notas de verdade dentro dele: com título, data e etiquetas preservados e — quando o arquivo diz a que passagem pertence — ligados àquele versículo, exatamente como se você tivesse escrito a nota no aplicativo enquanto lia.
Funciona nos dois sentidos. As notas exportadas deste site levam livro, capítulo e versículo, então voltam exatamente para o lugar de onde saíram. As notas escritas em outro lugar geralmente não levam nada disso, e por isso esta página explica as uma ou duas linhas que as posicionam — e o que acontece quando um arquivo não as tem.
Passo a passo
Crie um backup no JW Library
Abra o JW Library, vá em Estudo pessoal, toque no menu de três pontos, escolha Backup e restauração e depois Criar um backup. Isso gera um arquivo .jwlibrary — a biblioteca à qual suas notas serão adicionadas.
Abra o Explorador de estudo
Acesse jwsync.org, abra o Explorador de estudo e carregue esse arquivo .jwlibrary. Tudo acontece dentro do seu navegador; o arquivo nunca é enviado para lugar nenhum.
Toque em “Importar Markdown”
O botão fica ao lado de “Exportar Markdown”. Escolha quantos arquivos .md quiser, ou um .zip com eles — inclusive o .zip que este site gera ao exportar.
Leia o resumo antes que algo seja escrito
Você vê quantas notas vão cair num versículo, quantas serão adicionadas como notas avulsas e quantas já estão no seu backup e serão ignoradas. Tudo o que o site precisou interpretar aparece linha a linha, com uma caixa de seleção, para você decidir em vez de descobrir depois.
Exporte e restaure
Toque em “Exportar .jwlibrary” e restaure esse arquivo no JW Library em Backup e restauração → Restaurar. Suas notas importadas já fazem parte da biblioteca naquele aparelho.
O menor arquivo que funciona
Um arquivo Markdown não precisa de nada para ser importado: um arquivo só com texto vira uma nota e tira o título do primeiro título interno ou, na falta dele, do nome do arquivo. Todo o resto serve para dizer onde a nota vai. Um arquivo completo fica assim: --- title: O cálice pelo qual ele orou tags: [estudo, getsêmani] publication: Matthew 26:39 --- A oração dele mostra submissão, não relutância. O bloco entre as duas linhas de traços se chama front matter. As linhas abaixo são a nota em si.
Os campos que são lidos
Só cinco coisas são lidas, e cada uma aceita vários nomes para você não precisar decorar um exato. **title** (ou name, heading) vira o título da nota. **tags** (ou tag, keywords, categories, labels, topics) viram etiquetas reais do JW Library, criadas se ainda não existirem. **date** (ou created, modified) define a data da nota; qualquer valor que contenha AAAA-MM-DD é entendido. **publication** (ou pub, reference, ref, scripture, citation, source, passage) é onde você escreve a passagem. **book**, **chapter** e **verse** (ou ch, v, vs, verses) fazem o mesmo em campos separados. Qualquer outro campo que você mantenha por conta própria — autor, status, o que seu editor acrescentar — é ignorado em vez de virar erro.
Três maneiras de apontar uma nota para um versículo
Escreva a passagem numa linha: `publication: Matthew 26:39`. Ou separe: `book: Matthew`, `chapter: 26`, `verse: 39`. Ou use as duas coisas — é o que a exportação deste site faz, para o arquivo ficar legível para uma pessoa e exato para uma máquina. As três formas dão o mesmo resultado, então use a que combinar com o editor onde você escreve.
Quanta liberdade a passagem admite
Os nomes dos livros são reconhecidos com generosidade. Funcionam os nomes completos e também as abreviações que as pessoas realmente digitam: Matt, Matt., Mt, 1 Cor, 1Cor, I Corinthians, Second Timothy, Psalm além de Psalms, Song of Songs além de Song of Solomon. O separador entre capítulo e versículo pode ser dois-pontos, ponto ou a letra v — `John 3:16`, `John 3.16` e `1 Cor 13 v4` são lidos igual. Espaços são opcionais, então `1Cor13:4` também serve. O front matter é igualmente tolerante. Os nomes dos campos podem ter maiúsculas. O espaço depois dos dois-pontos pode faltar. Espaços e tabulações extras são ignorados, assim como aspas em volta dos valores e um comentário final com #. Quebras de linha do Windows não atrapalham. Você pode até deixar de fora as linhas --- e começar o arquivo direto pelos campos, desde que a primeira linha seja um dos nomes reconhecidos — essa regra existe para que uma nota que comece com uma frase comum contendo dois-pontos não perca o primeiro parágrafo.
Etiquetas, escritas como você quiser
Todas estas formas produzem as mesmas duas etiquetas: `tags: [estudo, grego]`, `tags: estudo, grego`, `tags: estudo; grego`, `tags: #estudo #grego`, ou uma lista em linhas próprias abaixo de `tags:` com cada item começando por um traço. Etiquetas que já existem na sua biblioteca são reaproveitadas em vez de duplicadas, então a nota importada entra na mesma etiqueta que você já usa para filtrar.
O que acontece quando algo não está claro
Nada de incerto é decidido por você. Se o nome de um livro é parecido com um real mas não exato — `Mathew`, `Ecclesiates` —, a nota não é colocada automaticamente. Ela aparece no resumo, em sua própria linha, dizendo o que o site entendeu: “lido como Matthew 26:39”, com uma caixa de seleção. Desmarque e ela fica de fora; deixe marcada e ela vai para onde a linha diz. Se o livro não for reconhecido de jeito nenhum, a linha avisa e a nota é adicionada como nota avulsa — nunca forçada sobre um palpite. Um livro numerado mantém o número, então `1 Jonh` só pode ser corrigido para 1 John, jamais para 2 John.
O que ele deliberadamente não faz
Um intervalo de versículos ancora a nota no primeiro deles: `Matthew 26:39-41` coloca a nota no versículo 39, porque uma nota do JW Library se prende a um ponto do texto, não a um trecho. Uma passagem com capítulo mas sem versículo — `Matthew 26` — prende a nota àquele capítulo. Um arquivo que nomeia uma publicação em vez de uma passagem — `The Watchtower—2023 No. 4` — é importado como nota avulsa comum, sem perguntar nada, porque é exatamente isso que a exportação deste site escreve para notas feitas num artigo.
A formatação que sobrevive à viagem
Parágrafos, quebras de linha, **negrito**, *itálico* e listas com marcadores chegam como formatação real no JW Library. Um título no começo do arquivo é usado como título da nota em vez de ser repetido dentro dela. Tudo o que o Markdown expressa e as notas do JW Library não — tabelas, imagens, links, blocos de código — é reduzido ao texto, então nenhuma palavra se perde mesmo quando o layout não pode ser mantido.
Onde as notas realmente vão parar, e por que isso é seguro
Para prender uma nota a um versículo, o JW Library precisa de identificadores internos daquele capítulo que são específicos da sua biblioteca. O JW Sync nunca os inventa. Ele reaproveita o local que o seu próprio backup já tem para aquele capítulo, ou copia esses identificadores de outro local bíblico do mesmo arquivo. Se um backup não contiver nenhuma nota ou marcação na Bíblia, não há de onde copiar, então as notas entram como notas avulsas em vez de serem presas a algo que o aplicativo talvez não reconheça. É uma escolha deliberada: uma nota que cai silenciosamente no lugar errado é pior do que uma que chega claramente solta.
Importar os mesmos arquivos duas vezes
Uma nota é considerada já presente quando título, texto e lugar coincidem com algo do backup, então reimportar a mesma exportação não duplica nada. O resumo informa quantas serão ignoradas por esse motivo antes de você confirmar. Tudo o que uma importação acrescenta é um passo de Desfazer, e as notas importadas recebem a etiqueta “Imported”, para você encontrá-las, filtrá-las ou apagá-las em grupo depois.
Perguntas frequentes
- Preciso usar as linhas ---?
- Não. Elas deixam o arquivo sem ambiguidade e todo editor de Markdown as entende, mas você também pode começar o arquivo direto pelos campos — `title: …` na primeira linha — ou dispensar o front matter e deixar a nota pegar o título do primeiro título interno.
- E se eu escrever errado o nome de um livro?
- Normalmente o site descobre o que você quis dizer, mas não age só por isso. A nota aparece no resumo dizendo como foi lida, com uma caixa de seleção, para você confirmar antes de qualquer coisa ser escrita.
- Posso importar uma pasta inteira do Obsidian?
- Selecione de uma vez quantos arquivos .md quiser, ou compacte a pasta e escolha o .zip. Os arquivos de dentro são lidos igual aos soltos.
- Importar vai sobrescrever as notas que já tenho?
- Não. Importar só acrescenta. Suas notas, marcações, marcadores e etiquetas atuais ficam intactos, e o arquivo carregado nunca é modificado — no fim você baixa um .jwlibrary novo.
- Minhas notas são enviadas para algum lugar?
- Não. Tudo roda no seu navegador, como o resto do site. Nem o backup nem os arquivos Markdown saem do seu aparelho.
- Em que idiomas posso escrever a passagem?
- Por enquanto os nomes dos livros são reconhecidos em inglês, que é também o que a exportação escreve. Se você escreve suas notas em outro idioma, use os campos `book`, `chapter` e `verse` com o nome do livro em inglês, ou importe as notas soltas e posicione-as à mão depois.
- Consigo tirar minhas notas de novo?
- Sim — “Exportar Markdown”, na mesma tela, grava cada nota num arquivo .md com os mesmos campos, então as notas podem sair do JW Library e voltar sem perder o lugar a que pertencem.