Retour aux articles
  • Guides
  • Export
  • Obsidian

Envoyer vos notes Kontenu dans Obsidian, pas à pas

Choisissez entre un dossier du coffre et la connexion locale à Obsidian. Préparez la destination, testez un premier envoi et vérifiez les notes avant d’exporter un lot.

Équipe KontenuPublié le
Les destinations disponibles dans les réglages d’export
Trois destinations : téléchargement, dossier du navigateur et connexion locale à Obsidian. Le modèle de note reste indépendant.

Choisir comment les notes arrivent dans votre coffre

Kontenu propose deux façons d’écrire dans un coffre Obsidian : sélectionner un dossier de ce coffre depuis le navigateur, ou utiliser le plugin Local REST API. Vous pouvez aussi télécharger vos notes, puis les déplacer vous-même dans le coffre.

DestinationCe qu’il faut préparer
Téléchargement directAucun accès à Obsidian ; vous déplacez ensuite les fichiers
Export vers dossierUn navigateur compatible et une autorisation d’écriture sur le dossier choisi
Connexion à ObsidianObsidian ouvert, le plugin actif et une connexion locale fonctionnelle

Ouvrez Réglages → Export → Fournisseurs pour retrouver ces destinations.

Les destinations disponibles dans les réglages d’export
Trois destinations : téléchargement, dossier du navigateur et connexion locale à Obsidian. Le modèle de note reste indépendant.

Le modèle de note est indépendant de la destination. Préparez-le dans Templates avant de commencer : le nom du fichier, les propriétés YAML et les rubriques seront utilisés pour fabriquer votre note.

Écrire dans un dossier du coffre

Cette option utilise le choix de dossier du navigateur. Sur ordinateur, utilisez un navigateur compatible, comme Chrome ou Edge.

  1. Dans Fournisseurs, ouvrez Export dans dossier.

  2. Cliquez sur Parcourir.

  3. Sélectionnez un dossier d’essai dans votre coffre Obsidian.

  4. Accordez au navigateur l’accès demandé pour y écrire.

  5. Vérifiez le dossier indiqué avant de lancer l’export.

État initial du fournisseur dossier, avant autorisation
Aucun dossier n’est sélectionné dans cette démonstration. Parcourir demande l’accès ; cet écran ne prouve pas une écriture réussie.

La capture montre l’état initial, avant autorisation. Tant qu’aucun dossier n’est prêt, vous ne pouvez pas lancer cette destination. Le navigateur doit obtenir votre accord ; Kontenu ne peut pas le donner à votre place.

Dans Associations → Gérer les filtres, vérifiez également l’option Écraser. Si elle est désactivée, un fichier déjà présent est ignoré. Si elle est activée, ce fichier peut être remplacé.

Pour ce premier essai, ouvrez la fiche d’un seul contenu, puis la petite flèche de l’export. Choisissez vers dossier, vérifiez le modèle et confirmez. Ouvrez ensuite le dossier dans Obsidian et contrôlez la note.

Depuis les réglages Fournisseurs, l’export reprend le filtre courant et peut donc créer un lot. Vérifiez le nombre annoncé et réduisez cette sélection à un seul contenu si vous commencez depuis cet écran.

Connecter directement Obsidian

La connexion REST relie votre navigateur à Obsidian sur le même ordinateur. Obsidian doit rester ouvert et le plugin Local REST API, version 4.1.3 ou ultérieure, doit être activé. Utilisez Chrome ou Edge sur ordinateur, avec Kontenu dans son onglet principal.

  1. Dans les plugins communautaires d’Obsidian, installez Local REST API et activez-le.

  2. Ouvrez les réglages du plugin pour retrouver l’adresse locale et votre clé API.

  3. Dans Kontenu, ouvrez Fournisseurs, puis le panneau Obsidian (REST API) et sa section Connexion à Obsidian.

  4. Renseignez l’adresse `https://127.0.0.1:27124` et votre propre clé API.

  5. Cliquez sur Tester. Si le navigateur demande l’accès au réseau local, autorisez-le pour cette connexion.

  6. Si Kontenu signale un problème de certificat, utilisez Ouvrir le certificat. Vérifiez le certificat local du plugin, puis revenez tester la connexion.

  7. Choisissez le dossier de destination dans le coffre.

Le formulaire initial de connexion locale à Obsidian
La clé est volontairement vide. Cette capture explique les champs ; elle ne montre ni connexion réussie ni note reçue.

Le guide officiel de Local REST API précise où retrouver la clé et le certificat. La capture de Kontenu garde le champ de clé vide.

Une connexion propre au navigateur

L’adresse, le dossier et la clé Obsidian sont conservés dans le navigateur utilisé, pour l’adresse du site Kontenu concernée. La clé y est stockée chiffrée. Passer d’Edge au navigateur intégré de Codex, ou à une autre adresse de Kontenu, ne transfère pas cette connexion. Un template exporté en JSON ne la contient pas non plus.

Si votre navigateur intégré ne permet pas d’accepter le certificat ou d’accorder l’accès nécessaire, effectuez cette connexion dans un navigateur compatible. Le menu d’export unitaire garde Obsidian grisé tant qu’il n’est pas disponible dans ce navigateur.

Faire un premier envoi

  1. Ouvrez la fiche d’un contenu dans Kontenu.

  2. Ouvrez la petite flèche de l’export et choisissez vers Obsidian REST.

  3. Dans Confirmer l’export, vérifiez le modèle et la destination.

  4. Confirmez, puis retrouvez la note dans le dossier choisi de votre coffre.

  5. Contrôlez le titre, le lien source, les propriétés et les rubriques.

Le YAML placé au début du fichier alimente les propriétés de la note. Consultez l’aide des propriétés d’Obsidian pour leur présentation et leurs types. La mise en forme du corps dépend de votre thème et de vos extensions.

Vérifier le chemin avant de renvoyer

Obsidian REST remplace une note qui existe déjà au même chemin. L’option Écraser du fournisseur dossier ne protège pas cette destination REST. Commencez dans un dossier d’essai et choisissez un nom de fichier adapté.

Pour un lot, vérifiez le nombre de notes et les modèles dans le récapitulatif avant de confirmer. Une opération Obsidian est limitée à 100 contenus.

Si la note n’arrive pas

Ce que vous constatezVérification utile
Le dossier reste indisponibleAutorisation d’écriture accordée dans ce navigateur et dossier toujours accessible
Obsidian reste griséApplication ouverte, plugin actif, certificat et test de connexion
La connexion fonctionne dans Edge seulementProfil et autorisations propres au navigateur utilisé
Une ancienne note a changéMême dossier et même nom de fichier ; la connexion REST peut la remplacer
La note existe, mais son résumé est videRésumé disponible dans Kontenu avant l’export

Une fois la première note vérifiée, reprenez le même modèle et la même destination pour une sélection plus large.