Comment importer des notes Markdown dans JW Library
Transformez des fichiers .md d'Obsidian, de Notion ou de n'importe quel éditeur Markdown en véritables notes JW Library, placées sur le bon verset — gratuit, privé, dans votre navigateur.
JW Library n'offre aucun moyen d'importer du texte. Vous pouvez écrire des notes dans l'application, mais une note rédigée ailleurs — dans Obsidian, dans Notion, dans un simple fichier texte — n'a aucun chemin vers votre bibliothèque. On finit par tout retaper, ou par renoncer et garder deux jeux de notes d'étude qui ne se rejoignent jamais.
JW Sync comble ce manque. Chargez une sauvegarde dans l'Explorateur d'étude, appuyez sur « Importer du Markdown », et vos fichiers .md deviennent de vraies notes à l'intérieur : titre, date et étiquettes conservés et — quand le fichier indique le passage concerné — rattachées à ce verset, exactement comme si vous aviez écrit la note dans l'application en le lisant.
Cela fonctionne dans les deux sens. Les notes exportées depuis ce site portent leur livre, leur chapitre et leur verset : elles retournent donc précisément d'où elles venaient. Les notes écrites ailleurs ne portent en général rien de tel, et c'est pourquoi cette page explique les une ou deux lignes qui les placent — et ce qui se passe quand un fichier ne les a pas.
Pas à pas
Créez une sauvegarde dans JW Library
Ouvrez JW Library, allez dans Étude personnelle, touchez le menu à trois points, choisissez Sauvegarde et restauration, puis Créer une sauvegarde. Vous obtenez un fichier .jwlibrary — la bibliothèque à laquelle vos notes seront ajoutées.
Ouvrez l'Explorateur d'étude
Allez sur jwsync.org, ouvrez l'Explorateur d'étude et chargez ce fichier .jwlibrary. Tout se passe dans votre navigateur ; le fichier n'est jamais envoyé nulle part.
Appuyez sur « Importer du Markdown »
Le bouton se trouve à côté d'« Exporter en Markdown ». Choisissez autant de fichiers .md que vous voulez, ou un .zip qui les contient — y compris le .zip que ce site produit à l'export.
Lisez le récapitulatif avant que quoi que ce soit soit écrit
On vous indique combien de notes se placeront sur un verset, combien seront ajoutées comme notes libres, et combien figurent déjà dans votre sauvegarde et seront ignorées. Tout ce que le site a dû interpréter est listé ligne par ligne, avec une case à cocher, pour que vous décidiez au lieu de le découvrir ensuite.
Exportez et restaurez
Appuyez sur « Exporter .jwlibrary », puis restaurez ce fichier dans JW Library via Sauvegarde et restauration → Restaurer. Vos notes importées font désormais partie de votre bibliothèque sur cet appareil.
Le fichier le plus court qui fonctionne
Un fichier Markdown n'a besoin de rien pour être importé : un fichier ne contenant que du texte devient une note, dont le titre vient du premier titre interne ou, à défaut, du nom du fichier. Tout le reste sert à dire où va la note. Un fichier complet ressemble à ceci : --- title: La coupe pour laquelle il a prié tags: [étude, gethsémané] publication: Matthew 26:39 --- Sa prière montre la soumission, non la réticence. Le bloc entre les deux lignes de tirets s'appelle le front matter. Les lignes en dessous sont la note elle-même.
Les champs qui sont lus
Cinq choses seulement sont lues, et chacune accepte plusieurs noms pour vous éviter d'en retenir un précis. **title** (ou name, heading) devient le titre de la note. **tags** (ou tag, keywords, categories, labels, topics) deviennent de vraies étiquettes JW Library, créées si elles n'existent pas encore. **date** (ou created, modified) fixe la date de la note ; toute valeur contenant AAAA-MM-JJ est comprise. **publication** (ou pub, reference, ref, scripture, citation, source, passage) est l'endroit où vous écrivez le passage. **book**, **chapter** et **verse** (ou ch, v, vs, verses) font la même chose dans des champs séparés. Tout autre champ que vous gardez pour votre usage — auteur, statut, ce que votre éditeur ajoute — est ignoré plutôt que traité comme une erreur.
Trois façons de rattacher une note à un verset
Écrivez la référence sur une ligne : `publication: Matthew 26:39`. Ou découpez-la : `book: Matthew`, `chapter: 26`, `verse: 39`. Ou faites les deux — c'est ce que fait l'export de ce site, pour que le fichier se lise bien pour un humain et s'analyse exactement pour une machine. Les trois donnent le même résultat : utilisez ce qui convient à votre éditeur.
Jusqu'où la référence peut être approximative
Les noms de livres sont reconnus largement. Les noms complets fonctionnent, et aussi les abréviations que les gens tapent réellement : Matt, Matt., Mt, 1 Cor, 1Cor, I Corinthians, Second Timothy, Psalm aussi bien que Psalms, Song of Songs aussi bien que Song of Solomon. Le séparateur entre chapitre et verset peut être deux-points, un point ou la lettre v — `John 3:16`, `John 3.16` et `1 Cor 13 v4` se lisent de la même façon. Les espaces sont facultatifs, donc `1Cor13:4` convient aussi. Le front matter est tout aussi tolérant. Les noms de champs peuvent porter des majuscules. L'espace après les deux-points peut manquer. Les espaces et tabulations superflus sont ignorés, de même que les guillemets autour des valeurs et un commentaire final avec #. Les fins de ligne Windows ne posent pas de problème. Vous pouvez même omettre les lignes --- et commencer le fichier directement par les champs, à condition que la toute première ligne soit l'un des noms reconnus — cette règle existe pour qu'une note débutant par une phrase ordinaire contenant deux-points ne perde pas son premier paragraphe.
Les étiquettes, écrites comme vous voulez
Toutes ces formes produisent les deux mêmes étiquettes : `tags: [étude, grec]`, `tags: étude, grec`, `tags: étude; grec`, `tags: #étude #grec`, ou une liste sur ses propres lignes sous `tags:`, chaque entrée commençant par un tiret. Les étiquettes qui existent déjà dans votre bibliothèque sont réutilisées et non dupliquées : la note importée rejoint donc l'étiquette avec laquelle vous filtrez déjà.
Ce qui se passe quand quelque chose n'est pas clair
Rien d'incertain n'est décidé à votre place. Si un nom de livre ressemble à un vrai sans être exact — `Mathew`, `Ecclesiates` —, la note n'est pas placée automatiquement. Elle apparaît dans le récapitulatif, sur sa propre ligne, avec ce que le site en a compris : « lu comme Matthew 26:39 », et une case à cocher. Décochez-la et elle est laissée de côté ; laissez-la cochée et elle va là où la ligne l'indique. Si le livre n'est pas reconnu du tout, la ligne le dit et la note est ajoutée comme note libre — jamais forcée sur une supposition. Un livre numéroté garde son numéro : `1 Jonh` ne peut être corrigé qu'en 1 Jean, jamais en 2 Jean.
Ce qu'il ne fera délibérément pas
Une plage de versets rattache la note à son premier verset : `Matthew 26:39-41` place la note au verset 39, parce qu'une note JW Library s'attache à un point du texte et non à un intervalle. Une référence avec un chapitre mais sans verset — `Matthew 26` — rattache la note à ce chapitre. Un fichier qui nomme une publication plutôt qu'un passage — `The Watchtower—2023 No. 4` — est importé comme note libre ordinaire sans aucune question, puisque c'est exactement ce que l'export de ce site écrit pour une note prise dans un article.
La mise en forme qui survit au voyage
Les paragraphes, les retours à la ligne, le **gras**, l'*italique* et les listes à puces arrivent sous forme de vraie mise en forme dans JW Library. Un titre en tête de fichier sert de titre à la note au lieu d'être répété à l'intérieur. Tout ce que Markdown sait exprimer et que les notes JW Library ne savent pas — tableaux, images, liens, blocs de code — est réduit à son texte : aucun mot n'est perdu, même quand la disposition ne peut pas être reprise.
Où les notes atterrissent réellement, et pourquoi c'est sûr
Pour rattacher une note à un verset, JW Library a besoin d'identifiants internes de ce chapitre, propres à votre bibliothèque. JW Sync ne les invente jamais. Il réutilise l'emplacement que votre propre sauvegarde possède déjà pour ce chapitre, ou copie ces identifiants depuis un autre emplacement biblique du même fichier. Si une sauvegarde ne contient aucune note ni surlignage dans la Bible, il n'y a rien à copier : les notes sont alors ajoutées comme notes libres plutôt que rattachées à quelque chose que l'application pourrait ne pas reconnaître. C'est un choix délibéré : une note qui atterrit silencieusement au mauvais endroit est pire qu'une note qui arrive franchement détachée.
Importer deux fois les mêmes fichiers
Une note est considérée comme déjà présente quand son titre, son texte et son emplacement correspondent à quelque chose dans la sauvegarde : réimporter le même export ne double donc rien. Le récapitulatif vous dit combien seront ignorées pour cette raison avant que vous validiez. Tout ce qu'un import ajoute constitue une seule étape d'annulation, et les notes importées reçoivent l'étiquette « Imported » pour que vous puissiez ensuite les retrouver, les filtrer ou les supprimer en bloc.
Questions fréquentes
- Suis-je obligé d'utiliser les lignes --- ?
- Non. Elles rendent le fichier sans ambiguïté et tous les éditeurs Markdown les comprennent, mais vous pouvez aussi commencer le fichier directement par les champs — `title: …` en première ligne — ou vous passer du front matter et laisser la note prendre son titre du premier titre interne.
- Et si j'écris mal un nom de livre ?
- Le site devine généralement ce que vous vouliez dire, mais il n'agit pas sur cette seule base. La note apparaît dans le récapitulatif avec la lecture retenue et une case à cocher, pour que vous confirmiez avant que quoi que ce soit soit écrit.
- Puis-je importer un dossier Obsidian entier ?
- Sélectionnez autant de fichiers .md que vous voulez en une fois, ou compressez le dossier et choisissez le .zip. Les fichiers qu'il contient sont lus comme les fichiers isolés.
- L'import va-t-il écraser mes notes existantes ?
- Non. L'import ne fait qu'ajouter. Vos notes, surlignages, signets et étiquettes actuels ne sont pas touchés, et le fichier chargé n'est jamais modifié — vous téléchargez un nouveau .jwlibrary à la fin.
- Mes notes sont-elles envoyées quelque part ?
- Non. Tout fonctionne dans votre navigateur, comme le reste du site. Ni votre sauvegarde ni vos fichiers Markdown ne quittent votre appareil.
- Dans quelles langues puis-je écrire la référence ?
- Pour l'instant les noms de livres sont reconnus en anglais, ce que l'export écrit également. Si vous rédigez vos notes dans une autre langue, utilisez les champs `book`, `chapter` et `verse` avec le nom anglais du livre, ou importez les notes détachées et placez-les ensuite à la main.
- Puis-je ressortir mes notes ?
- Oui — « Exporter en Markdown », sur le même écran, écrit chaque note dans un fichier .md avec les mêmes champs : les notes peuvent donc sortir de JW Library et y revenir sans perdre leur place.