Zo schrijf je een Markdown-bestand dat in JW Library te importeren is
Schrijf een aantekening in Kladblok, TextEdit of Obsidian en laat hem op het juiste vers in JW Library terechtkomen. Precies welke regels je typt, en alles wat je mag weglaten.
JW Sync kan Markdown-bestanden inlezen in een JW Library-back-up, en daarmee blijft er nog maar één vraag over die er echt toe doet zodra je weet dat die functie bestaat: hoe moet dat bestand eruitzien? Deze pagina beantwoordt dat vanaf de kant van de schrijver — niet wat de import accepteert, maar wat jij daadwerkelijk typt.
Kort gezegd is een aantekening een tekstbestand. Maak een bestand, schrijf de aantekening, sla hem op met .md aan het eind, en hij wordt geïmporteerd. Al het andere hier gaat over één optionele regel: die welke zegt bij welk schriftgedeelte de aantekening hoort, zodat hij in JW Library verschijnt terwijl je dat vers leest in plaats van los tussen je andere aantekeningen te blijven liggen.
Niets hiervan vraagt om een Markdown-editor, en niets vraagt dat je Markdown leert. Kladblok in Windows en TextEdit op een Mac zijn genoeg. Houd je je studieaantekeningen al bij in Obsidian of Notion, dan zijn die bestanden al Markdown, en verderop staat voor allebei een apart stukje.
Stap voor stap
Open een willekeurige editor voor platte tekst
Kladblok in Windows, TextEdit op een Mac, of de Markdown-app die je toch al gebruikt — Obsidian, Typora, iA Writer, Joplin. Het enige om te vermijden is een tekstverwerker: Word en Google Documenten slaan opmaak op in plaats van platte tekst, en geen van beide levert een bestand op dat de import kan lezen.
Typ de aantekening
Zet de titel op de eerste regel met een # ervoor, laat een lege regel en schrijf de aantekening eronder. Dat is al een volledig, geldig bestand. Wil je liever geen titelregel schrijven, dan wordt de bestandsnaam gebruikt.
Sla hem op met .md aan het eind
Noem hem hoe je wilt — mijn aantekening.md. In Windows slaat Kladblok een .txt op zolang je niet eerst ”Opslaan als type” op ”Alle bestanden” zet, en daar gaat het het vaakst mis. Op een Mac kies je Opmaak en dan Zet om in platte tekst voordat je opslaat.
Voeg de regel toe die hem op een vers plaatst
Helemaal bovenaan in het bestand, boven al het andere, schrijf je een regel van drie streepjes, dan publication: Matthew 26:39, en dan weer drie streepjes. De aantekening hangt nu aan dat vers. Laat je dit weg, dan wordt de aantekening alsnog geïmporteerd — hij komt alleen los binnen.
Importeer hem in een back-up
Ga in JW Library naar Persoonlijke studie, open het menu met drie puntjes, kies Back-up maken en terugzetten en maak een back-up. Laad dat bestand op jwsync.org in de Studieverkenner, druk op ”Markdown importeren”, kies je .md-bestanden en lees de samenvatting die je te zien krijgt voordat er iets wordt weggeschreven. Druk daarna op ”.jwlibrary exporteren” en zet dat bestand terug in JW Library.
Het kortste bestand dat werkt
Een bestand met niets anders dan tekst erin is al een geldige aantekening. Dit is het hele ding:
# De beker waarom hij bad Zijn gebed toont onderworpenheid, geen tegenzin.
De regel die met # begint wordt de titel van de aantekening, en alles eronder wordt de aantekening. Dat bestand wordt zonder morren geïmporteerd. Het komt gewoon binnen als losse aantekening, tussen je aantekeningen in plaats van gekoppeld aan een schriftgedeelte.
Het bestand maken in Windows
Open Kladblok, typ de aantekening en kies Bestand en Opslaan als. Zet vóór het opslaan ”Opslaan als type” van ”Tekstdocumenten” op ”Alle bestanden” — zonder die stap plakt Kladblok er stilletjes .txt achter en houd je mijn aantekening.md.txt over, die de import niet ziet. Typ dan de naam met .md aan het eind. Windows waarschuwt misschien dat het wijzigen van de extensie het bestand onbruikbaar kan maken; juist die waarschuwing is het teken dat je het goed hebt gedaan.
Het bestand maken op een Mac
Open TextEdit en kies Opmaak en dan Zet om in platte tekst voordat je ook maar iets typt. TextEdit start in de modus voor opgemaakte tekst en slaat .rtf op, en dat is helemaal geen tekstbestand. Zodra hij in de modus voor platte tekst staat, kies je Archief en Bewaar en laat je de naam op .md eindigen. Biedt macOS aan om er .txt achter te zetten, sla dat af.
Het bestand maken op een telefoon of tablet
Elke app die Markdown kan opslaan of exporteren voldoet — Obsidian, Bear, iA Writer, Joplin, Markor op Android. De ingebouwde notitie-apps van iPhone en Android kunnen doorgaans geen .md-bestand opslaan, dus op een telefoon loopt de gebruikelijke weg via zo'n app, of gewoon via een computer. Bij het importeren kun je zoveel bestanden tegelijk selecteren als je wilt, en een hele map kun je zippen en als één .zip aanleveren.
De ene regel die een aantekening op een vers plaatst
Alles wat de import vertelt waar de aantekening hoort, staat in een klein blok helemaal bovenaan het bestand, tussen twee regels van drie streepjes. Dat heet front matter, en voor de meeste aantekeningen is het één regel lang:
--- publication: Matthew 26:39 --- # De beker waarom hij bad Zijn gebed toont onderworpenheid, geen tegenzin.
Die aantekening hangt nu aan Mattheüs 26:39. Hij verschijnt in JW Library terwijl je dat vers leest, precies alsof je hem daar in de app had geschreven.
De verwijzing zo schrijven dat hij begrepen wordt
Schrijf de naam van het Bijbelboek in het Engels, ook als de aantekening zelf in een andere taal is: Matthew, niet Mattheüs. De afkortingen die mensen echt typen worden ook begrepen — Matt, Matt., Mt, 1 Cor, 1Cor, I Corinthians, Second Timothy. Tussen hoofdstuk en vers mag een dubbele punt, een punt of de letter v staan, dus John 3:16, John 3.16 en 1 Cor 13 v4 betekenen hetzelfde, en spaties zijn optioneel, zodat 1Cor13:4 ook prima is. Een bereik als Matthew 26:39-41 zet de aantekening op het eerste vers, 39, omdat een JW Library-aantekening aan één punt in de tekst hangt en niet aan een reeks.
Het volledige bestand, met titel, datum en labels
Er zijn nog drie regels beschikbaar als je die wilt, en ze zijn allemaal optioneel:
--- title: De beker waarom hij bad date: 2026-08-15 tags: [studie, gethsemane] publication: Matthew 26:39 --- Zijn gebed toont onderworpenheid, geen tegenzin.
title doet hetzelfde als de kop met #, dus één van de twee volstaat. date zet de datum van de aantekening in plaats van de dag waarop je importeerde. tags worden echte JW Library-labels waarop je kunt filteren, en een label dat je al hebt wordt hergebruikt in plaats van gedupliceerd. De tags-regel kan ook geschreven worden als studie, gethsemane zonder haken, of als #studie #gethsemane, of als een lijst met streepjes op aparte regels eronder — alle vier worden hetzelfde gelezen.
Eén aantekening per bestand
Elk .md-bestand wordt één aantekening. Meerdere aantekeningen in één bestand zetten en ze laten splitsen kan niet, want niets in een Markdown-bestand markeert betrouwbaar waar de ene aantekening eindigt en de volgende begint — een kop halverwege kan een tweede aantekening zijn of een tussenkop van de eerste, en misgokken zou verspreiden wat je hebt geschreven. Schrijf dus één bestand per aantekening en selecteer ze bij het importeren allemaal tegelijk, of zip de map en kies de .zip.
Opmaak die heel aankomt
Alinea's, regelafbrekingen, vet, cursief en opsommingen komen in JW Library aan als echte opmaak. Koppen na de eerste worden gewone alinea's. Alles wat Markdown kan uitdrukken en een JW Library-aantekening niet — tabellen, afbeeldingen, links, codeblokken — wordt teruggebracht tot de tekst, zodat de woorden overleven ook waar de vormgeving niet mee kan.
Als je al in Obsidian schrijft
Obsidian-bestanden zijn al Markdown, en het eigenschappenpaneel schrijft precies de front matter die hier beschreven staat: voeg een eigenschap publication toe met de waarde Matthew 26:39 en de aantekening landt daar. Obsidians eigen eigenschap tags wordt gelezen als tags. Links tussen dubbele blokhaken en ingesloten notities worden teruggebracht tot hun tekst, want een JW Library-aantekening heeft nergens om ze heen te wijzen. Je kunt de .md-bestanden van een hele map in één import selecteren, of de map zippen en de .zip aanleveren.
Als je al in Notion schrijft
Notion kan Markdown exporteren: open het paginamenu, kies Exporteren en wijs ”Markdown & CSV” aan. Wat je krijgt is een .zip, die de import zo aanneemt. Notion schrijft de paginatitel als kop en zijn eigen eigenschappen als gewone regels eronder, en velden die de import niet kent worden genegeerd in plaats van als fout behandeld — dus om een aantekening op een vers te plaatsen zet je zelf een publication-regel bovenaan het geëxporteerde bestand.
Dingen die je niet goed hoeft te krijgen
Hoofdletters in de veldnamen maken niet uit. De spatie na de dubbele punt mag ontbreken. Extra spaties en tabs worden genegeerd, net als aanhalingstekens om een waarde en een opmerking achter een #. Regeleindes van Windows zijn geen probleem. Je mag de ---regels zelfs helemaal weglaten en het bestand direct met de velden beginnen, zolang de allereerste regel er een van is. En als je een boeknaam verkeerd spelt — Mathew — zegt de import dat hij dat gelezen heeft als Matthew 26:39 en wacht hij tot jij het vinkje zet, in plaats van het zelf te beslissen.
Wat importeren niet met je bibliotheek doet
Importeren voegt alleen maar toe. De aantekeningen, markeringen, bladwijzers en labels die al in je back-up zitten blijven onaangeroerd, en het bestand dat je laadt wordt nooit gewijzigd — aan het eind download je een nieuwe .jwlibrary en die zet je terug. Een aantekening waarvan titel, tekst en plaats allemaal overeenkomen met iets wat al in de back-up staat, wordt overgeslagen, dus dezelfde bestanden tweemaal importeren verdubbelt niets. Alles wat een import toevoegt is één stap Ongedaan maken, en geïmporteerde aantekeningen dragen het label Imported, zodat je ze later kunt terugvinden, erop kunt filteren of ze als groep kunt verwijderen. Niets ervan verlaat je apparaat.
Veelgestelde vragen
- Moet ik eerst Markdown leren?
- Nee. Een bestand met gewone zinnen is al een geldige aantekening. Markdown komt er pas bij kijken als je vet, cursief of opsommingstekens wilt, en zelfs dan is het twee sterretjes om een woord voor vet en een streepje aan het begin van de regel voor een opsommingsteken.
- Maakt de bestandsnaam uit?
- Alleen als het bestand geen eigen titel heeft. Is er geen title:-regel en geen kop met #, dan wordt de bestandsnaam opgeschoond en in plaats daarvan gebruikt, dus de-beker-waarom-hij-bad.md wordt een aantekening met de naam ”de beker waarom hij bad”. Verder mag het bestand heten wat je wilt.
- En als ik hem per ongeluk als .txt heb opgeslagen?
- Hernoem hem zodat hij op .md eindigt en importeer opnieuw — aan de inhoud hoeft niets te veranderen. In Windows moet je misschien eerst bestandsnaamextensies aanzetten in het menu Beeld van de Verkenner, anders is de uitgang voor je verborgen.
- Mag ik de boeknaam in mijn eigen taal schrijven?
- Voorlopig niet. Boeknamen worden in het Engels herkend, en dat is ook wat de Markdown-export van deze site schrijft. Schrijf de aantekening in welke taal je wilt; alleen de verwijzingsregel heeft de Engelse naam nodig. Wil je dat liever niet, laat de verwijzing dan weg en plaats de aantekening later met de hand.
- Kan ik meer dan één aantekening in één bestand zetten?
- Nee — elk bestand wordt één aantekening. Selecteer bij één import zoveel bestanden als je wilt, of zip de map en kies de .zip.
- Verandert dit de aantekeningen die ik al heb?
- Nee. Importeren voegt alleen toe. Je bestaande aantekeningen blijven onaangeroerd, en de back-up die je laadt wordt nooit gewijzigd: aan het eind download je een nieuw bestand en bepaal je zelf of je het terugzet.
- Wat gebeurt er als ik de verwijzingsregel weglaat?
- De aantekening wordt gewoon geïmporteerd. Hij komt als losse aantekening in je bibliotheek in plaats van gekoppeld aan een schriftgedeelte — en dat is meestal precies wat een aantekening over een lezing, een gesprek of een eigen gedachte wil.