Comment écrire un fichier Markdown qui s'importe dans JW Library
Écrivez une note dans le Bloc-notes, TextEdit ou Obsidian et faites-la arriver sur le bon verset dans JW Library. Les lignes exactes à taper, et tout ce que vous pouvez omettre.
JW Sync sait lire des fichiers Markdown pour les faire entrer dans une sauvegarde JW Library, ce qui soulève la seule question qui compte vraiment une fois qu'on sait que la fonction existe : à quoi le fichier doit-il ressembler ? Cette page y répond du côté de celui qui écrit — non pas ce que l'importateur accepte, mais ce que vous tapez réellement.
En bref, une note est un fichier texte. Créez le fichier, écrivez la note, enregistrez-le en le terminant par .md, et il s'importera. Tout le reste de cette page porte sur une seule ligne facultative : celle qui indique à quel passage la note appartient, pour qu'elle apparaisse dans JW Library pendant que vous lisez ce verset au lieu de rester isolée parmi vos autres notes.
Rien de tout cela n'exige un éditeur Markdown, et rien n'exige que vous appreniez le Markdown. Le Bloc-notes sous Windows et TextEdit sur Mac suffisent. Si vous tenez déjà vos notes d'étude dans Obsidian ou Notion, ces fichiers sont déjà du Markdown, et il y a une section pour chacun plus bas.
Pas à pas
Ouvrez n'importe quel éditeur de texte brut
Le Bloc-notes sous Windows, TextEdit sur Mac, ou l'application Markdown que vous utilisez déjà — Obsidian, Typora, iA Writer, Joplin. La seule chose à éviter est un traitement de texte : Word et Google Docs enregistrent de la mise en forme plutôt que du texte brut, et ni l'un ni l'autre ne produit un fichier que l'importateur puisse lire.
Tapez la note
Mettez le titre sur la première ligne, précédé d'un #, laissez une ligne vide, puis écrivez la note en dessous. C'est déjà un fichier complet et valide. Si vous préférez ne pas écrire de ligne de titre, c'est le nom du fichier qui sera utilisé.
Enregistrez-le en le terminant par .md
Appelez-le comme vous voulez : ma note.md. Sous Windows, le Bloc-notes enregistre un .txt tant que vous n'avez pas changé « Type » en « Tous les fichiers » — c'est l'erreur la plus fréquente. Sur Mac, choisissez Format puis Convertir au format texte avant d'enregistrer.
Ajoutez la ligne qui place la note sur un verset
Tout en haut du fichier, au-dessus de tout le reste, écrivez une ligne de trois tirets, puis publication: Matthew 26:39, puis de nouveau trois tirets. La note est désormais rattachée à ce verset. Sans cette ligne, la note s'importe quand même : elle arrive simplement non rattachée.
Importez-la dans une sauvegarde
Dans JW Library, allez dans Étude personnelle, ouvrez le menu à trois points, choisissez Sauvegarde et restauration et créez une sauvegarde. Chargez ce fichier sur jwsync.org, dans l'Explorateur d'étude, appuyez sur « Importer du Markdown », choisissez vos fichiers .md et lisez le récapitulatif affiché avant que quoi que ce soit soit écrit. Appuyez ensuite sur « Exporter .jwlibrary » et restaurez ce fichier dans JW Library.
Le fichier le plus court qui fonctionne
Un fichier ne contenant que du texte est déjà une note valide. Le voici en entier :
# La coupe pour laquelle il a prié Sa prière montre la soumission, non la réticence.
La ligne qui commence par # devient le titre de la note, et tout ce qui se trouve en dessous devient la note. Ce fichier s'importe sans protester. Il arrive simplement comme une note isolée, parmi vos notes plutôt que rattachée à un passage.
Créer le fichier sous Windows
Ouvrez le Bloc-notes, tapez la note, puis choisissez Fichier et Enregistrer sous. Avant d'enregistrer, changez « Type » de « Documents texte » à « Tous les fichiers » — sans cette étape, le Bloc-notes ajoute discrètement .txt et vous vous retrouvez avec ma note.md.txt, que l'importateur ne verra pas. Tapez ensuite le nom en le terminant par .md. Windows peut vous avertir que changer l'extension risque de rendre le fichier inutilisable ; cet avertissement est le signe que vous avez bien fait.
Créer le fichier sur un Mac
Ouvrez TextEdit et choisissez Format puis Convertir au format texte avant de taper quoi que ce soit. TextEdit démarre en mode texte enrichi et enregistre du .rtf, qui n'est pas du tout un fichier texte. Une fois en mode texte brut, choisissez Fichier puis Enregistrer, et terminez le nom par .md. Si macOS propose d'ajouter le .txt, refusez.
Créer le fichier sur un téléphone ou une tablette
N'importe quelle application capable d'enregistrer ou d'exporter du Markdown convient — Obsidian, Bear, iA Writer, Joplin, Markor sur Android. Les applications Notes intégrées à l'iPhone et à Android ne savent généralement pas enregistrer un fichier .md, donc sur téléphone la voie habituelle passe par l'une de ces applications, ou tout simplement par un ordinateur. Au moment d'importer, vous pouvez sélectionner autant de fichiers que vous voulez d'un coup, et un dossier entier peut être compressé et fourni sous forme d'un seul .zip.
La seule ligne qui place une note sur un verset
Tout ce qui indique à l'importateur où va la note se met dans un petit bloc tout en haut du fichier, entre deux lignes de trois tirets. Cela s'appelle le front matter, et pour la plupart des notes il tient sur une ligne :
--- publication: Matthew 26:39 --- # La coupe pour laquelle il a prié Sa prière montre la soumission, non la réticence.
Cette note est maintenant rattachée à Matthieu 26:39. Elle apparaît dans JW Library pendant que vous lisez ce verset, exactement comme si vous l'aviez écrite là depuis l'application.
Écrire la référence pour qu'elle soit comprise
Écrivez le nom du livre en anglais, même quand la note est dans une autre langue : Matthew, et non Matthieu. Les abréviations que les gens tapent réellement sont comprises elles aussi — Matt, Matt., Mt, 1 Cor, 1Cor, I Corinthians, Second Timothy. Entre le chapitre et le verset, vous pouvez utiliser deux-points, un point ou la lettre v : John 3:16, John 3.16 et 1 Cor 13 v4 veulent tous dire la même chose, et les espaces sont facultatifs, si bien que 1Cor13:4 convient aussi. Un intervalle comme Matthew 26:39-41 place la note sur le premier verset, le 39, car une note JW Library se rattache à un point du texte et non à un passage entier.
Le fichier complet, avec un titre, une date et des étiquettes
Trois lignes de plus sont disponibles si vous les voulez, et toutes sont facultatives :
--- title: La coupe pour laquelle il a prié date: 2026-08-15 tags: [étude, gethsémané] publication: Matthew 26:39 --- Sa prière montre la soumission, non la réticence.
title fait la même chose que le titre précédé d'un #, donc l'un des deux suffit. date fixe la date de la note au lieu de laisser le jour de l'importation. tags deviennent de vraies étiquettes JW Library sur lesquelles vous pouvez filtrer, et une étiquette que vous avez déjà est réutilisée plutôt que dupliquée. La ligne tags peut aussi s'écrire étude, gethsémané sans crochets, ou #étude #gethsémané, ou encore sous forme de liste à tirets sur des lignes séparées en dessous — les quatre formes se lisent de la même façon.
Une note par fichier
Chaque fichier .md devient une note. Il n'y a pas moyen de mettre plusieurs notes dans un même fichier et de les faire séparer, car rien dans un fichier Markdown ne marque de façon fiable où une note se termine et où la suivante commence — un titre à mi-chemin peut être une deuxième note comme il peut être un sous-titre de la première, et se tromper disperserait ce que vous avez écrit. Écrivez donc un fichier par note, puis sélectionnez-les tous d'un coup au moment d'importer, ou compressez le dossier et choisissez le .zip.
La mise en forme qui arrive intacte
Les paragraphes, les retours à la ligne, le gras, l'italique et les listes à puces arrivent dans JW Library comme véritable mise en forme. Les titres situés après le premier deviennent des paragraphes ordinaires. Tout ce que le Markdown sait exprimer et qu'une note JW Library ne sait pas — tableaux, images, liens, blocs de code — est réduit à son texte, de sorte que les mots survivent même là où la mise en page ne peut pas suivre.
Si vous écrivez déjà dans Obsidian
Les fichiers Obsidian sont déjà du Markdown, et son panneau Propriétés écrit exactement le front matter décrit ici : ajoutez une propriété nommée publication avec la valeur Matthew 26:39 et la note atterrira là. La propriété tags propre à Obsidian est lue comme tags. Les liens entre doubles crochets et les notes intégrées sont réduits à leur texte, puisqu'une note JW Library n'a nulle part où les faire pointer. Vous pouvez sélectionner tous les .md d'un dossier en une seule importation, ou compresser le dossier et fournir le .zip.
Si vous écrivez déjà dans Notion
Notion sait exporter du Markdown : ouvrez le menu de la page, choisissez Exporter et sélectionnez « Markdown & CSV ». Ce que vous obtenez est un .zip, que l'importateur accepte tel quel. Notion écrit le titre de la page sous forme de titre et ses propres propriétés sous forme de lignes ordinaires en dessous, et les champs que l'importateur ne reconnaît pas sont ignorés plutôt que traités comme des erreurs — donc, pour placer une note sur un verset, ajoutez vous-même une ligne publication en haut du fichier exporté.
Ce que vous n'avez pas besoin de réussir
Les majuscules dans les noms de champs n'ont aucune importance. L'espace après les deux-points peut manquer. Les espaces et tabulations en trop sont ignorés, tout comme les guillemets autour d'une valeur et un commentaire écrit après un #. Les fins de ligne Windows ne posent pas de problème. Vous pouvez même omettre complètement les lignes --- et commencer le fichier directement par les champs, à condition que la toute première ligne en soit un. Et si vous écrivez mal le nom d'un livre — Mathew —, l'importateur vous dit qu'il a lu cela comme Matthew 26:39 et attend que vous cochiez la case, au lieu de trancher tout seul.
Ce que l'importation ne fera pas à votre bibliothèque
Importer ne fait qu'ajouter. Les notes, surlignages, signets et étiquettes déjà présents dans votre sauvegarde ne sont pas touchés, et le fichier que vous chargez n'est jamais modifié — à la fin vous téléchargez un nouveau .jwlibrary et c'est celui-là que vous restaurez. Une note dont le titre, le texte et l'emplacement correspondent à quelque chose qui se trouve déjà dans la sauvegarde est ignorée, donc importer deux fois les mêmes fichiers ne double rien. Tout ce qu'une importation ajoute tient en une seule étape d'Annuler, et les notes importées portent une étiquette Imported, ce qui vous permet ensuite de les retrouver, de filtrer dessus ou de les supprimer en bloc. Rien de tout cela ne quitte votre appareil.
Questions fréquentes
- Dois-je d'abord apprendre le Markdown ?
- Non. Un fichier de phrases ordinaires est déjà une note valide. Le Markdown n'intervient que si vous voulez du gras, de l'italique ou des puces, et même là il s'agit de deux astérisques autour d'un mot pour le gras et d'un tiret en début de ligne pour une puce.
- Le nom du fichier a-t-il de l'importance ?
- Seulement quand le fichier n'a pas de titre à lui. S'il n'y a ni ligne title: ni titre précédé d'un #, le nom du fichier est nettoyé et utilisé à la place : la-coupe-pour-laquelle-il-a-prie.md devient une note appelée « la coupe pour laquelle il a prie ». Sinon, appelez le fichier comme bon vous semble.
- Et si je l'ai enregistré en .txt par erreur ?
- Renommez-le pour qu'il se termine par .md et réimportez — rien dans le contenu n'a besoin de changer. Sous Windows, il faudra peut-être d'abord activer les extensions de noms de fichiers dans le menu Affichage de l'Explorateur, sinon la terminaison vous est cachée.
- Puis-je écrire le nom du livre dans ma langue ?
- Pas pour l'instant. Les noms de livres sont reconnus en anglais, ce qui est aussi ce qu'écrit l'export Markdown de ce site. Écrivez la note dans la langue que vous voulez ; seule la ligne de référence a besoin du nom anglais. Si vous préférez, laissez la référence de côté et placez la note à la main ensuite.
- Puis-je mettre plusieurs notes dans un même fichier ?
- Non — chaque fichier devient une note. Sélectionnez autant de fichiers que vous voulez lors d'une importation, ou compressez le dossier et choisissez le .zip.
- Est-ce que cela va modifier les notes que j'ai déjà ?
- Non. Importer ne fait qu'ajouter. Vos notes existantes ne sont pas touchées, et la sauvegarde que vous chargez n'est jamais modifiée : à la fin vous téléchargez un nouveau fichier et vous décidez si vous le restaurez.
- Que se passe-t-il si j'omets la ligne de référence ?
- La note s'importe quand même. Elle arrive comme une note isolée dans votre bibliothèque plutôt que rattachée à un passage — ce qui est justement ce que veut d'ordinaire une note sur un discours, une conversation ou une réflexion personnelle.