Come scrivere un file Markdown che si importa in JW Library
Scrivi una nota in Blocco note, TextEdit o Obsidian e falla arrivare sul versetto giusto in JW Library. Le righe esatte da digitare, e tutto quello che puoi omettere.
JW Sync sa leggere file Markdown dentro un backup di JW Library, il che solleva l'unica domanda che conta davvero una volta che sai che la funzione esiste: com'è fatto il file? Questa pagina risponde dal lato di chi scrive — non che cosa accetta l'importazione, ma che cosa digiti tu.
In breve, una nota è un file di testo. Crei il file, scrivi la nota, la salvi con .md alla fine e viene importata. Tutto il resto qui riguarda una sola riga facoltativa: quella che dice a quale passo appartiene la nota, così da farla comparire in JW Library mentre leggi quel versetto invece di lasciarla sciolta fra le altre note.
Niente di tutto questo richiede un editor Markdown, e niente richiede che tu impari il Markdown. Blocco note su Windows e TextEdit su Mac bastano. Se già tieni le tue note di studio in Obsidian o in Notion, quei file sono già Markdown, e più sotto c'è una sezione per ciascuno.
Passo passo
Apri un qualsiasi editor di testo semplice
Blocco note su Windows, TextEdit su Mac, o l'app Markdown che usi già — Obsidian, Typora, iA Writer, Joplin. L'unica cosa da evitare è un elaboratore di testi: Word e Google Documenti salvano impaginazione e formattazione invece di testo semplice, e nessuno dei due produce un file che l'importazione riesca a leggere.
Scrivi la nota
Metti il titolo sulla prima riga con un # davanti, lascia una riga vuota e scrivi la nota sotto. Questo è già un file completo e valido. Se preferisci non scrivere nessuna riga di titolo, viene usato il nome del file.
Salvalo con .md alla fine
Chiamalo come vuoi: la mia nota.md. Su Windows, Blocco note salva un .txt a meno che tu non cambi prima «Tipo file» in «Tutti i file», ed è l'errore più comune. Su Mac scegli Formato e poi Converti in testo normale prima di salvare.
Aggiungi la riga che lo mette su un versetto
In cima al file, sopra ogni altra cosa, scrivi una riga di tre trattini, poi publication: Matthew 26:39, poi di nuovo tre trattini. La nota è ora agganciata a quel versetto. Se lo ometti la nota viene importata lo stesso: arriva semplicemente non agganciata.
Importalo in un backup
In JW Library vai in Studio personale, apri il menu a tre puntini, scegli Backup e ripristino e crea un backup. Carica quel file su jwsync.org, nell'Esploratore di studio, premi «Importa Markdown», scegli i tuoi file .md e leggi il riepilogo che ti viene mostrato prima che venga scritto qualcosa. Poi premi «Esporta .jwlibrary» e ripristina quel file in JW Library.
Il file più corto che funziona
Un file che non contiene altro che testo è già una nota valida. È tutto qui:
# Il calice per cui pregò La sua preghiera mostra sottomissione, non riluttanza.
La riga che comincia con # diventa il titolo della nota, e tutto ciò che sta sotto diventa la nota. Quel file si importa senza protestare. Arriva semplicemente come nota a sé stante, fra le tue note anziché agganciata a un passo.
Creare il file su Windows
Apri Blocco note, scrivi la nota, poi scegli File e Salva con nome. Prima di salvare cambia «Tipo file» da «Documenti di testo» a «Tutti i file»: senza quel passaggio Blocco note aggiunge .txt per conto suo e ti ritrovi con la mia nota.md.txt, che l'importazione non vedrà. Poi digita il nome che finisce in .md. Windows potrebbe avvisarti che cambiare l'estensione può rendere il file inutilizzabile; quell'avviso è il segno che hai fatto giusto.
Creare il file su un Mac
Apri TextEdit e scegli Formato e poi Converti in testo normale prima di scrivere qualsiasi cosa. TextEdit parte in modalità testo formattato e salva .rtf, che non è affatto un file di testo. Una volta in modalità testo normale, scegli Archivio e Salva, e fai finire il nome con .md. Se macOS si offre di aggiungere il .txt, rifiuta.
Creare il file su telefono o tablet
Va bene qualunque app capace di salvare o esportare Markdown — Obsidian, Bear, iA Writer, Joplin, Markor su Android. Le app Note incluse in iPhone e Android di solito non riescono a salvare un file .md, quindi sul telefono la strada abituale è una di quelle app, oppure semplicemente scrivere al computer. Al momento di importare puoi selezionare quanti file vuoi in una volta, e un'intera cartella può essere compressa e consegnata come un unico .zip.
L'unica riga che mette una nota su un versetto
Tutto ciò che dice all'importazione dove va la nota sta in un piccolo blocco in cima al file, fra due righe di tre trattini. Si chiama front matter, e per la maggior parte delle note è lungo una riga:
--- publication: Matthew 26:39 --- # Il calice per cui pregò La sua preghiera mostra sottomissione, non riluttanza.
Quella nota è ora agganciata a Matteo 26:39. Compare in JW Library mentre leggi quel versetto, esattamente come se l'avessi scritta lì dall'app.
Scrivere il riferimento in modo che venga capito
Scrivi il nome del libro in inglese, anche quando la nota è in un'altra lingua: Matthew, non Matteo. Sono capite anche le abbreviazioni che la gente digita davvero — Matt, Matt., Mt, 1 Cor, 1Cor, I Corinthians, Second Timothy. Fra capitolo e versetto puoi usare i due punti, un punto o la lettera v, quindi John 3:16, John 3.16 e 1 Cor 13 v4 vogliono dire la stessa cosa, e gli spazi sono facoltativi, tanto che va bene anche 1Cor13:4. Un intervallo come Matthew 26:39-41 mette la nota sul primo versetto, il 39, perché una nota di JW Library si aggancia a un punto del testo e non a un tratto.
Il file completo, con titolo, data e tag
Ci sono altre tre righe a disposizione, se le vuoi, e sono tutte facoltative:
--- title: Il calice per cui pregò date: 2026-08-15 tags: [studio, getsemani] publication: Matthew 26:39 --- La sua preghiera mostra sottomissione, non riluttanza.
title fa lo stesso lavoro dell'intestazione con #, quindi ne basta uno dei due. date imposta la data della nota invece di lasciare il giorno in cui hai importato. tags diventano veri tag di JW Library con cui puoi filtrare, e un tag che hai già viene riutilizzato anziché duplicato. La riga tags si può scrivere anche studio, getsemani senza parentesi, oppure #studio #getsemani, oppure come elenco con trattini su righe separate sotto — tutte e quattro le forme si leggono allo stesso modo.
Una nota per file
Ogni file .md diventa una nota. Non c'è modo di mettere più note in uno stesso file e farle separare, perché niente in un file Markdown segna in modo affidabile dove finisce una nota e comincia la successiva: un'intestazione a metà strada potrebbe essere una seconda nota oppure un sottotitolo della prima, e sbagliare disperderebbe quello che hai scritto. Quindi scrivi un file per nota e poi selezionali tutti insieme al momento di importare, oppure comprimi la cartella e scegli lo .zip.
La formattazione che arriva intatta
Paragrafi, a capo, grassetto, corsivo ed elenchi puntati arrivano in JW Library come vera formattazione. Le intestazioni dopo la prima diventano paragrafi normali. Tutto ciò che il Markdown sa esprimere e una nota di JW Library no — tabelle, immagini, link, blocchi di codice — viene ridotto al suo testo, così le parole sopravvivono anche dove l'impaginazione non può seguirle.
Se già scrivi in Obsidian
I file di Obsidian sono già Markdown, e il suo pannello Proprietà scrive esattamente il front matter descritto qui: aggiungi una proprietà chiamata publication con valore Matthew 26:39 e la nota finirà lì. La proprietà tags di Obsidian viene letta come tags. I collegamenti fra doppie parentesi quadre e le note incorporate vengono ridotti al loro testo, dato che una nota di JW Library non ha dove puntarli. Puoi selezionare i .md di un'intera cartella in una sola importazione, oppure comprimere la cartella e consegnare lo .zip.
Se già scrivi in Notion
Notion sa esportare in Markdown: apri il menu della pagina, scegli Esporta e seleziona «Markdown & CSV». Quello che ottieni è uno .zip, che l'importazione accetta così com'è. Notion scrive il titolo della pagina come intestazione e le proprie proprietà come righe normali sotto, e i campi che l'importazione non riconosce vengono ignorati anziché trattati come errori — quindi, per mettere una nota su un versetto, aggiungi tu stesso una riga publication in cima al file esportato.
Cose che non devi azzeccare
Le maiuscole nei nomi dei campi non contano. Lo spazio dopo i due punti può mancare. Spazi e tabulazioni in più vengono ignorati, così come le virgolette attorno a un valore e un commento scritto dopo un #. Le fine riga di Windows vanno bene. Puoi perfino omettere del tutto le righe --- e cominciare il file direttamente con i campi, purché la primissima riga sia uno di essi. E se sbagli a scrivere il nome di un libro — Mathew — l'importazione ti dice che l'ha letto come Matthew 26:39 e aspetta che tu spunti la casella, invece di decidere da sola.
Cosa l'importazione non farà alla tua biblioteca
Importare aggiunge soltanto. Le note, le evidenziazioni, i segnalibri e i tag già presenti nel tuo backup restano intatti, e il file che carichi non viene mai modificato: alla fine scarichi un nuovo .jwlibrary e ripristini quello. Una nota il cui titolo, testo e collocazione coincidono con qualcosa che è già nel backup viene saltata, quindi importare due volte gli stessi file non raddoppia niente. Tutto ciò che un'importazione aggiunge è un solo passo di Annulla, e le note importate portano un tag Imported, così più tardi puoi trovarle, filtrarle o rimuoverle in blocco. Niente di tutto questo lascia il tuo dispositivo.
Domande frequenti
- Devo prima imparare il Markdown?
- No. Un file di frasi normali è già una nota valida. Il Markdown entra in gioco solo se vuoi grassetto, corsivo o elenchi puntati, e anche allora si tratta di due asterischi attorno a una parola per il grassetto e un trattino a inizio riga per un punto elenco.
- Il nome del file conta?
- Solo quando il file non ha un titolo suo. Se non c'è né la riga title: né un'intestazione con #, il nome del file viene ripulito e usato al suo posto, così il-calice-per-cui-prego.md diventa una nota chiamata «il calice per cui prego». Per il resto chiama il file come vuoi.
- E se l'ho salvato in .txt per sbaglio?
- Rinominalo perché finisca in .md e importalo di nuovo: al contenuto non serve cambiare nulla. Su Windows potresti dover prima attivare le estensioni dei nomi file nel menu Visualizza di Esplora file, altrimenti la terminazione ti resta nascosta.
- Posso scrivere il nome del libro nella mia lingua?
- Per ora no. I nomi dei libri sono riconosciuti in inglese, che è anche ciò che scrive l'esportazione Markdown di questo sito. Scrivi la nota nella lingua che preferisci; solo la riga del riferimento ha bisogno del nome inglese. Se preferisci, ometti il riferimento e colloca la nota a mano in seguito.
- Posso mettere più di una nota in un solo file?
- No: ogni file diventa una nota. Seleziona quanti file vuoi in una sola importazione, oppure comprimi la cartella e scegli lo .zip.
- Questo cambierà le note che ho già?
- No. Importare aggiunge soltanto. Le tue note esistenti restano intatte, e il backup che carichi non viene mai modificato: alla fine scarichi un file nuovo e decidi se ripristinarlo.
- Cosa succede se ometto la riga del riferimento?
- La nota si importa lo stesso. Arriva come nota a sé stante nella tua biblioteca invece che agganciata a un passo — che poi è proprio quello che di solito vuole una nota su un discorso, una conversazione o un pensiero personale.