Cómo escribir un archivo Markdown que se importe a JW Library
Escribe una nota en Bloc de notas, TextEdit u Obsidian y haz que caiga en el versículo correcto de JW Library. Las líneas exactas que hay que poner, y todo lo que puedes omitir.
JW Sync puede leer archivos Markdown y meterlos en una copia de seguridad de JW Library, lo cual plantea la única pregunta que de verdad importa una vez que sabes que la función existe: ¿qué aspecto tiene que tener el archivo? Esta página lo responde desde el lado de quien escribe: no qué acepta el importador, sino qué escribes tú.
La versión corta es que una nota es un archivo de texto. Crea el archivo, escribe la nota, guárdalo terminado en .md y se importará. Todo lo demás que hay aquí trata de una sola línea opcional: la que dice a qué pasaje pertenece la nota, para que aparezca en JW Library mientras lees ese versículo en lugar de quedarse suelta entre tus demás notas.
Nada de esto requiere un editor de Markdown, y nada requiere que aprendas Markdown. Bloc de notas en Windows y TextEdit en Mac son suficientes. Si ya guardas tus notas de estudio en Obsidian o en Notion, esos archivos ya son Markdown, y más abajo hay una sección para cada uno.
Paso a paso
Abre cualquier editor de texto plano
Bloc de notas en Windows, TextEdit en Mac o la aplicación de Markdown que ya uses: Obsidian, Typora, iA Writer, Joplin. Lo único que conviene evitar es un procesador de textos: Word y Google Docs guardan formato y maquetación en lugar de texto plano, y ninguno de los dos produce un archivo que el importador pueda leer.
Escribe la nota
Pon el título en la primera línea con una # delante, deja una línea en blanco y escribe la nota debajo. Eso ya es un archivo completo y válido. Si prefieres no escribir ninguna línea de título, se usará el nombre del archivo.
Guárdalo terminado en .md
Llámalo como quieras: mi nota.md. En Windows, el Bloc de notas guarda un .txt a menos que antes cambies «Tipo» a «Todos los archivos», que es lo que más se falla. En Mac, elige Formato y luego Convertir a texto normal antes de guardar.
Añade la línea que lo coloca en un versículo
Al principio del todo del archivo, por encima de cualquier otra cosa, escribe una línea con tres guiones, luego publication: Matthew 26:39, y luego otros tres guiones. La nota ya está unida a ese versículo. Si omites esto, la nota se importa igualmente: sencillamente llega sin unir.
Impórtalo a una copia de seguridad
En JW Library, ve a Estudio personal, abre el menú de tres puntos, elige Copia de seguridad y restauración y crea una copia. Carga ese archivo en jwsync.org, en el Explorador de estudio, pulsa «Importar Markdown», elige tus archivos .md y lee el resumen que se te muestra antes de que se escriba nada. Después pulsa «Exportar .jwlibrary» y restaura ese archivo en JW Library.
El archivo más corto que funciona
Un archivo que no contenga más que texto ya es una nota válida. Esto es todo:
# La copa por la que oró Su oración muestra sumisión, no reticencia.
La línea que empieza por # se convierte en el título de la nota, y todo lo que hay debajo es la nota. Ese archivo se importa sin protestar. Sencillamente llega como una nota suelta, entre tus notas y no unida a un pasaje.
Crear el archivo en Windows
Abre el Bloc de notas, escribe la nota y elige Archivo y Guardar como. Antes de guardar, cambia «Tipo» de «Documentos de texto» a «Todos los archivos»: sin ese paso el Bloc de notas añade .txt por su cuenta y acabas con mi nota.md.txt, que el importador no verá. Después escribe el nombre terminado en .md. Puede que Windows te avise de que cambiar la extensión podría inutilizar el archivo; ese aviso es la señal de que lo has hecho bien.
Crear el archivo en un Mac
Abre TextEdit y elige Formato y luego Convertir a texto normal antes de escribir nada. TextEdit arranca en modo de texto enriquecido y guarda .rtf, que no es un archivo de texto en absoluto. Una vez en modo de texto normal, elige Archivo y Guardar, y termina el nombre en .md. Si macOS se ofrece a añadirte el .txt, recházalo.
Crear el archivo en un móvil o una tableta
Sirve cualquier aplicación capaz de guardar o exportar Markdown: Obsidian, Bear, iA Writer, Joplin, Markor en Android. Las aplicaciones de notas que vienen de serie en iPhone y Android normalmente no pueden guardar un archivo .md, así que en el móvil el camino habitual es una de esas aplicaciones, o sencillamente escribir en un ordenador. Al importar puedes seleccionar tantos archivos como quieras a la vez, y una carpeta entera se puede comprimir y entregar como un único .zip.
La única línea que coloca una nota en un versículo
Todo lo que le dice al importador dónde va la nota se pone en un pequeño bloque al principio del todo del archivo, entre dos líneas de tres guiones. Se llama «front matter», y para la mayoría de las notas ocupa una sola línea:
--- publication: Matthew 26:39 --- # La copa por la que oró Su oración muestra sumisión, no reticencia.
Esa nota ya está unida a Mateo 26:39. Aparece en JW Library mientras lees ese versículo, exactamente como si la hubieras escrito allí desde la aplicación.
Cómo escribir la referencia para que se entienda
Escribe el nombre del libro en inglés, aunque la nota esté en otro idioma: Matthew, no Mateo. También se entienden las abreviaturas que la gente escribe de verdad: Matt, Matt., Mt, 1 Cor, 1Cor, I Corinthians, Second Timothy. Entre el capítulo y el versículo puedes usar dos puntos, un punto o la letra v, así que John 3:16, John 3.16 y 1 Cor 13 v4 significan lo mismo, y los espacios son opcionales, de modo que 1Cor13:4 también vale. Un intervalo como Matthew 26:39-41 coloca la nota en el primer versículo, el 39, porque una nota de JW Library se une a un punto del texto y no a un tramo.
El archivo completo, con título, fecha y etiquetas
Hay tres líneas más disponibles si las quieres, y todas son opcionales:
--- title: La copa por la que oró date: 2026-08-15 tags: [estudio, getsemaní] publication: Matthew 26:39 --- Su oración muestra sumisión, no reticencia.
title hace lo mismo que el encabezado con #, así que basta con uno de los dos. date fija la fecha de la nota en lugar de dejar el día en que la importaste. tags se convierten en etiquetas reales de JW Library por las que puedes filtrar, y una etiqueta que ya tengas se reutiliza en vez de duplicarse. La línea de tags también se puede escribir estudio, getsemaní sin corchetes, o #estudio #getsemaní, o como una lista con guiones en líneas aparte debajo: las cuatro formas se leen igual.
Una nota por archivo
Cada archivo .md se convierte en una nota. No hay forma de meter varias notas en un mismo archivo y que se separen, porque nada en un archivo Markdown marca de manera fiable dónde termina una nota y empieza la siguiente: un encabezado a mitad de camino podría ser una segunda nota o podría ser un subtítulo de la primera, y equivocarse dispersaría lo que has escrito. Así que escribe un archivo por nota y luego selecciónalos todos de una vez al importar, o comprime la carpeta y elige el .zip.
El formato que llega intacto
Los párrafos, los saltos de línea, la negrita, la cursiva y las listas con viñetas llegan a JW Library como formato de verdad. Los encabezados posteriores al primero se convierten en párrafos normales. Todo lo que Markdown puede expresar y una nota de JW Library no —tablas, imágenes, enlaces, bloques de código— se reduce a su texto, así que las palabras sobreviven aunque la maquetación no pueda seguirlas.
Si ya escribes en Obsidian
Los archivos de Obsidian ya son Markdown, y su panel de propiedades escribe exactamente el front matter que se describe aquí: añade una propiedad llamada publication con el valor Matthew 26:39 y la nota irá a parar allí. La propiedad tags del propio Obsidian se lee como tags. Los enlaces entre dobles corchetes y las notas incrustadas se reducen a su texto, porque una nota de JW Library no tiene adónde apuntarlos. Puedes seleccionar los .md de una carpeta entera en una sola importación, o comprimir la carpeta y entregar el .zip.
Si ya escribes en Notion
Notion puede exportar Markdown: abre el menú de la página, elige Exportar y selecciona «Markdown & CSV». Lo que obtienes es un .zip, que el importador acepta tal cual. Notion escribe el título de la página como encabezado y sus propias propiedades como líneas normales debajo, y los campos que el importador no reconoce se ignoran en lugar de tratarse como errores; así que, para colocar una nota en un versículo, añade tú mismo una línea publication al principio del archivo exportado.
Cosas que no hace falta que aciertes
Las mayúsculas en los nombres de los campos dan igual. El espacio después de los dos puntos puede faltar. Los espacios y tabulaciones de más se ignoran, igual que las comillas alrededor de un valor y un comentario escrito después de una #. Los finales de línea de Windows están bien. Incluso puedes prescindir de las líneas --- y empezar el archivo directamente con los campos, siempre que la primerísima línea sea uno de ellos. Y si escribes mal el nombre de un libro —Mathew—, el importador te dice que lo ha leído como Matthew 26:39 y espera a que marques la casilla, en vez de decidirlo por su cuenta.
Lo que la importación no le hará a tu biblioteca
Importar solo añade. Las notas, los subrayados, los marcadores y las etiquetas que ya hay en tu copia de seguridad no se tocan, y el archivo que cargas nunca se modifica: al final descargas un .jwlibrary nuevo y restauras ese. Una nota cuyo título, texto y ubicación coincidan con algo que ya está en la copia se omite, así que importar los mismos archivos dos veces no duplica nada. Todo lo que añade una importación es un solo paso de Deshacer, y las notas importadas llevan una etiqueta Imported, de modo que después puedes encontrarlas, filtrarlas o eliminarlas como grupo. Nada de esto sale de tu dispositivo.
Preguntas frecuentes
- ¿Tengo que aprender Markdown antes?
- No. Un archivo con frases normales ya es una nota válida. Markdown solo entra en juego si quieres negrita, cursiva o viñetas, y aun así es poner dos asteriscos alrededor de una palabra para la negrita y un guion al principio de la línea para una viñeta.
- ¿Importa el nombre del archivo?
- Solo cuando el archivo no tiene título propio. Si no hay línea title: ni encabezado con #, se limpia el nombre del archivo y se usa en su lugar, así que la-copa-por-la-que-oro.md se convierte en una nota llamada «la copa por la que oro». Por lo demás, llama al archivo como quieras.
- ¿Y si lo he guardado como .txt sin querer?
- Cámbiale el nombre para que termine en .md e impórtalo otra vez; no hay que tocar el contenido. En Windows puede que antes tengas que activar las extensiones de nombre de archivo en el menú Vista del Explorador, o la terminación estará oculta.
- ¿Puedo escribir el nombre del libro en mi idioma?
- De momento no. Los nombres de los libros se reconocen en inglés, que es también lo que escribe la exportación de Markdown de este sitio. Escribe la nota en el idioma que quieras; solo la línea de la referencia necesita el nombre en inglés. Si prefieres no hacerlo, omite la referencia y coloca la nota a mano después.
- ¿Puedo poner más de una nota en un mismo archivo?
- No: cada archivo se convierte en una nota. Selecciona tantos archivos como quieras en una importación, o comprime la carpeta y elige el .zip.
- ¿Esto cambiará las notas que ya tengo?
- No. Importar solo añade. Tus notas existentes no se tocan, y la copia de seguridad que cargas nunca se modifica: al final descargas un archivo nuevo y decides si lo restauras.
- ¿Qué pasa si omito la línea de la referencia?
- La nota se importa igual. Llega como una nota suelta en tu biblioteca en vez de unida a un pasaje, que es justo lo que suele querer una nota sobre un discurso, una conversación o una reflexión personal.