Cómo importar notas de Markdown a JW Library
Convierte archivos .md de Obsidian, Notion o cualquier editor de Markdown en notas reales de JW Library, colocadas en el versículo correcto: gratis, privado y en tu navegador.
JW Library no tiene ninguna forma de importar texto. Puedes escribir notas dentro de la aplicación, pero una nota escrita en otro sitio —en Obsidian, en Notion, en un archivo de texto del ordenador— no tiene ningún camino hacia tu biblioteca. La gente acaba copiándolas a mano, o se rinde y mantiene dos juegos de notas de estudio que nunca se encuentran.
JW Sync cierra ese hueco. Carga una copia de seguridad en el Explorador de estudio, pulsa «Importar Markdown» y tus archivos .md se convierten en notas reales dentro de ella: con su título, su fecha y sus etiquetas intactos y, cuando el archivo indica a qué pasaje pertenece, unidos a ese versículo, igual que si hubieras escrito la nota en la aplicación mientras lo leías.
Funciona en los dos sentidos. Las notas exportadas desde este sitio llevan su libro, capítulo y versículo, así que vuelven exactamente al lugar del que salieron. Las notas escritas en otro sitio no suelen llevar nada de eso, y por eso esta página explica las una o dos líneas que las colocan, y qué pasa cuando un archivo no las tiene.
Paso a paso
Crea una copia de seguridad en JW Library
Abre JW Library, entra en Estudio personal, toca el menú de tres puntos, elige Copia de seguridad y restauración y luego Crear una copia de seguridad. Eso te da un archivo .jwlibrary: la biblioteca a la que se añadirán tus notas.
Abre el Explorador de estudio
Entra en jwsync.org, abre el Explorador de estudio y carga ese archivo .jwlibrary. Todo ocurre dentro de tu navegador; el archivo no se sube a ningún sitio.
Pulsa «Importar Markdown»
El botón está junto a «Exportar Markdown». Elige tantos archivos .md como quieras, o un .zip con ellos, incluido el .zip que genera este sitio al exportar.
Lee el resumen antes de que se escriba nada
Se te dice cuántas notas irán a un versículo, cuántas se añadirán como notas sueltas y cuántas ya están en tu copia y se omitirán. Todo lo que el sitio haya tenido que interpretar aparece línea por línea, con una casilla, para que decidas tú y no lo descubras después.
Exporta y restaura
Pulsa «Exportar .jwlibrary» y restaura ese archivo en JW Library desde Copia de seguridad y restauración → Restaurar. Tus notas importadas ya forman parte de tu biblioteca en ese dispositivo.
El archivo más corto que funciona
Un archivo de Markdown no necesita nada para poder importarse: un archivo con solo texto se convierte en una nota y toma su título del primer encabezado o, si no lo hay, del nombre del archivo. Todo lo demás sirve para indicar dónde va la nota. Un archivo completo se ve así: --- title: La copa por la que oró tags: [estudio, getsemaní] publication: Matthew 26:39 --- Su oración muestra sumisión, no reticencia. El bloque entre las dos líneas de guiones se llama «front matter». Las líneas de debajo son la nota en sí.
Los campos que se leen
Solo se leen cinco cosas, y cada una admite varios nombres para que no tengas que acordarte de uno exacto. **title** (o name, heading) es el título de la nota. **tags** (o tag, keywords, categories, labels, topics) se convierten en etiquetas reales de JW Library, que se crean si aún no existen. **date** (o created, modified) fija la fecha de la nota; se entiende cualquier valor que contenga AAAA-MM-DD. **publication** (o pub, reference, ref, scripture, citation, source, passage) es donde escribes el pasaje. **book**, **chapter** y **verse** (o ch, v, vs, verses) hacen lo mismo en campos separados. Cualquier otro campo que conserves para tus propios fines —autor, estado, lo que añada tu editor— se ignora en vez de tratarse como un error.
Tres maneras de apuntar una nota a un versículo
Escribe el pasaje en una línea: `publication: Matthew 26:39`. O sepáralo: `book: Matthew`, `chapter: 26`, `verse: 39`. O usa ambas cosas: eso es lo que hace la exportación de este sitio, para que el archivo se lea bien para una persona y se analice con exactitud para una máquina. Las tres formas dan el mismo resultado, así que usa la que mejor le venga a tu editor.
Cuánto margen admite el pasaje
Los nombres de los libros se reconocen con generosidad. Funcionan los nombres completos y también las abreviaturas que la gente escribe de verdad: Matt, Matt., Mt, 1 Cor, 1Cor, I Corinthians, Second Timothy, Psalm además de Psalms, Song of Songs además de Song of Solomon. El separador entre capítulo y versículo puede ser dos puntos, un punto o la letra v: `John 3:16`, `John 3.16` y `1 Cor 13 v4` se leen igual. Los espacios son opcionales, así que `1Cor13:4` también vale. El front matter es igual de tolerante. Los nombres de campo pueden ir en mayúsculas. Puede faltar el espacio después de los dos puntos. Se ignoran los espacios y tabulaciones de sobra, las comillas alrededor de los valores y un comentario final con #. Los finales de línea de Windows no molestan. Incluso puedes omitir las líneas --- y empezar el archivo directamente con los campos, siempre que la primera línea sea uno de los nombres reconocidos: esa regla existe para que una nota que empiece con una frase normal que lleve dos puntos no pierda su primer párrafo.
Las etiquetas, como quieras escribirlas
Todas estas formas producen las mismas dos etiquetas: `tags: [estudio, griego]`, `tags: estudio, griego`, `tags: estudio; griego`, `tags: #estudio #griego`, o una lista en líneas propias debajo de `tags:` con cada entrada empezando por un guion. Las etiquetas que ya existen en tu biblioteca se reutilizan en lugar de duplicarse, así que la nota importada se suma a la misma etiqueta por la que ya filtras.
Qué pasa cuando algo no está claro
No se decide nada dudoso por ti. Si el nombre de un libro se parece a uno real pero no es exacto —`Mathew`, `Ecclesiates`—, la nota no se coloca automáticamente. Aparece en el resumen, en su propia línea, diciendo cómo lo ha entendido el sitio: «se ha leído como Matthew 26:39», con una casilla. Desmárcala y se queda fuera; déjala marcada y va donde dice la línea. Si el libro no se reconoce en absoluto, la línea lo indica y la nota se añade como nota suelta, nunca forzada sobre una suposición. Un libro numerado conserva su número, así que `1 Jonh` solo puede corregirse a 1 John, jamás a 2 John.
Lo que a propósito no hace
Un rango de versículos ancla la nota a su primer versículo: `Matthew 26:39-41` la coloca en el versículo 39, porque una nota de JW Library se une a un punto del texto y no a un tramo. Un pasaje con capítulo pero sin versículo —`Matthew 26`— une la nota a ese capítulo. Un archivo que nombra una publicación en vez de un pasaje —`The Watchtower—2023 No. 4`— se importa como nota suelta normal sin preguntar nada, porque eso es justo lo que escribe la exportación de este sitio para las notas tomadas en un artículo.
El formato que sobrevive al viaje
Los párrafos, los saltos de línea, la **negrita**, la *cursiva* y las listas con viñetas llegan como formato real a JW Library. Un encabezado al principio del archivo se usa como título de la nota en lugar de repetirse dentro. Todo lo que Markdown puede expresar y las notas de JW Library no —tablas, imágenes, enlaces, bloques de código— se reduce a su texto, así que no se pierde ninguna palabra aunque no se pueda conservar la disposición.
Dónde acaban las notas de verdad, y por qué eso es seguro
Para unir una nota a un versículo, JW Library necesita unos identificadores internos de ese capítulo que son propios de tu biblioteca. JW Sync nunca se los inventa. Reutiliza la ubicación que tu propia copia ya tiene para ese capítulo, o copia esos identificadores de otra ubicación bíblica del mismo archivo. Si una copia no contiene ninguna nota ni subrayado en la Biblia, no hay nada de donde copiarlos, así que las notas se añaden sueltas en vez de unirse a algo que la aplicación podría no reconocer. Es una decisión deliberada: una nota que acaba en silencio en el lugar equivocado es peor que una que llega claramente sin unir.
Importar los mismos archivos dos veces
Una nota se considera ya presente cuando coinciden su título, su texto y su lugar con algo de la copia, así que volver a importar la misma exportación no duplica nada. El resumen te dice cuántas se omiten por ese motivo antes de confirmar. Todo lo que añade una importación es un paso de «Deshacer», y las notas importadas llevan la etiqueta «Imported» para que después puedas encontrarlas, filtrarlas o borrarlas en grupo.
Preguntas frecuentes
- ¿Tengo que usar las líneas ---?
- No. Dejan el archivo sin ambigüedad y cualquier editor de Markdown las entiende, pero también puedes empezar el archivo directamente con los campos —`title: …` en la primera línea— o prescindir del front matter y dejar que la nota tome su título del primer encabezado.
- ¿Y si escribo mal el nombre de un libro?
- Normalmente el sitio deduce lo que querías decir, pero no actúa solo por eso. La nota aparece en el resumen indicando cómo se ha leído, con una casilla, para que confirmes antes de que se escriba nada.
- ¿Puedo importar una carpeta entera de Obsidian?
- Selecciona de una vez tantos archivos .md como quieras, o comprime la carpeta y elige el .zip. Los archivos de dentro se leen igual que los sueltos.
- ¿Importar sobrescribirá las notas que ya tengo?
- No. Importar solo añade. Tus notas, subrayados, marcadores y etiquetas actuales no se tocan, y el archivo que cargaste nunca se modifica: al final descargas un .jwlibrary nuevo.
- ¿Se suben mis notas a algún sitio?
- No. Todo funciona en tu navegador, como el resto del sitio. Ni tu copia de seguridad ni tus archivos de Markdown salen de tu dispositivo.
- ¿En qué idiomas puedo escribir el pasaje?
- De momento los nombres de los libros se reconocen en inglés, que es también lo que escribe la exportación. Si escribes tus notas en otro idioma, usa los campos `book`, `chapter` y `verse` con el nombre del libro en inglés, o importa las notas sin unir y colócalas a mano más tarde.
- ¿Puedo volver a sacar mis notas?
- Sí: «Exportar Markdown», en la misma pantalla, escribe cada nota en un archivo .md con los mismos campos, así que las notas pueden salir de JW Library y volver a entrar sin perder su sitio.