Obsidian Power Setup : Git & IA

Lors de mon passage chez D2SI/Revolve, Obsidian était fréquemment mentionné dans nos canaux de veille technologique comme l'une des meilleures solutions de prise de notes en raison de sa polyvalence, de son extensibilité et de sa simplicité.

Les principaux avantages d'Obsidian sont la sécurité des données et son prix. La version locale, sans cloud, est entièrement gratuite. Il bénéficie également d'une communauté de développeurs très active qui fournit des plugins stables et sécurisés pour améliorer votre expérience de prise de notes.

Bien que l'utilisation de base soit simple, l'organisation de vos notes peut parfois devenir compliquée. Cependant, c'est courant avec n'importe quel outil de "second cerveau" ; la structure dépend en fin de compte de la façon dont vous choisissez de l'organiser.

J'utilise Obsidian quotidiennement pour ma prise de notes personnelle et professionnelle. Je peux stocker en toute sécurité des documents, des graphes, des tâches et des prompts d'IA, tout en les gardant accessibles depuis n'importe quel appareil.

Dans cet article, je vais aborder mes deux plugins communautaires Obsidian préférés et comment les configurer, en me concentrant spécifiquement sur l'ajout de capacités d'IA et la synchronisation à distance.

Activer les Plugins Communautaires

Étape 1 : Désactiver le Mode Restreint

Par défaut, Obsidian fonctionne en "Mode Restreint" (Restricted Mode) pour empêcher l'exécution de code tiers non autorisé. Vous devez le désactiver pour utiliser des plugins communautaires.

  1. Ouvrez Obsidian.
  2. Allez dans les Paramètres en cliquant sur l'icône d'engrenage dans le coin inférieur gauche (ou utilisez le raccourci Cmd/Ctrl + ,).
  3. Dans la barre latérale gauche, sélectionnez Plugins communautaires (Community plugins).
  4. Cliquez sur le bouton Activer les plugins communautaires (Turn on community plugins).
  5. Un avertissement de sécurité apparaîtra expliquant les risques des plugins tiers. Cliquez sur Activer (Turn on) pour confirmer et désactiver le Mode Restreint.

Étape 2 : Parcourir et Installer les Plugins

Avec les plugins communautaires activés, vous pouvez maintenant accéder au référentiel de plugins directement depuis l'application.

  1. Toujours dans l'onglet Plugins communautaires, cliquez sur le bouton Parcourir (Browse).
  2. La boutique des plugins communautaires s'ouvrira. Vous pouvez :
    • Rechercher : Utilisez la barre de recherche en haut pour trouver des plugins spécifiques par nom ou mots-clés.
    • Trier : Triez la liste par téléchargements, récemment mis à jour ou date de sortie.
  3. Cliquez sur la carte d'un plugin pour lire sa documentation et comprendre son fonctionnement.
  4. Pour l'ajouter à votre coffre-fort, cliquez sur le bouton Installer (Install).

Étape 3 : Activer et Gérer les Plugins

L'installation d'un plugin se contente de le télécharger ; vous devez toujours l'activer.

  1. Après avoir cliqué sur "Installer", le bouton changera. Cliquez sur Activer (Enable) pour activer le plugin immédiatement.
  2. Méthode Alternative : Vous pouvez gérer tous vos plugins installés en retournant dans Paramètres > Plugins communautaires.
  3. Faites défiler jusqu'à la section Plugins installés (Installed plugins) :
    • Interrupteur à bascule : Activez ou désactivez les plugins sans les désinstaller.
    • Icône d'engrenage : Accédez aux paramètres spécifiques d'un plugin****.****
    • Icône de corbeille : Désinstallez complètement et supprimez le plugin de votre coffre-fort.

Obsidian Copilot

Obsidian Copilot est très bien noté pour une bonne raison : il donne des super-pouvoirs à Obsidian.

Il est compatible avec des modèles d'IA locaux et distants via des clés API. L'utilisation d'une IA locale offre un environnement de travail totalement sécurisé, gratuit et facilement configurable.

Dès son installation, il contient des prompts personnalisés qui rendent la prise de notes très efficace. Il vous permet également d'ajouter facilement vos propres prompts d'IA, ce qui signifie que la seule limite à la manipulation des données est votre imagination.

Copilot peut formater et corriger du texte adapté spécifiquement aux fonctionnalités markdown d'Obsidian. Grâce à son mode Vault QA, il agit comme un agent qui indexe vos données, vous permettant de récupérer, modifier et interroger vos notes en fonction de mots-clés et de leur signification sémantique.

Configurer Obsidian Copilot

Étape 1 : Configurer Votre Clé API

Le plugin Copilot nécessite une clé API d'un fournisseur LLM pour fonctionner.

  1. Obtenez une clé API auprès de votre fournisseur préféré (ex: OpenAI, Anthropic, Google AI Studio, ou un agrégateur comme OpenRouter).
  2. Ouvrez les Paramètres d'Obsidian (Cmd/Ctrl + ,).
  3. Faites défiler la barre latérale gauche et sélectionnez Copilot sous Plugins communautaires.
  4. Dans l'onglet Basic, cliquez sur Set Keys.
  5. Collez votre clé API dans le champ du fournisseur correspondant.
  6. Faites défiler jusqu'à la liste déroulante Default Chat Model et sélectionnez le modèle par défaut (ex: gpt-4o, claude-3-5-sonnet, ou gemini-2.0-flash).
  7. Cliquez sur Save and Reload pour appliquer la configuration. (Note : Si vous utilisez des modèles GenAI locaux via Ollama, vous pouvez les configurer en cliquant sur "Add Custom Model").

Étape 2 : Démarrage Rapide et Astuces de Workflow

Une fois activé, vous pouvez interagir avec l'IA directement dans votre environnement de prise de notes. Voici les moyens les plus efficaces de l'utiliser :

  • Le Chat Latéral : Cliquez sur l'icône du robot Copilot dans la barre latérale droite (ou lancez Copilot: Open Chat depuis la palette de commandes).
  • Ajouter du Contexte avec @ : Dans la fenêtre de chat, tapez @ suivi du nom d'un fichier pour charger instantanément une note spécifique dans le contexte du LLM.
  • Manipulation de Texte Inline : Surlignez n'importe quel bloc de texte, faites un clic droit, et sélectionnez une action Copilot (résumer, réécrire, développer).
  • Commandes Rapides : Surlignez du texte et appuyez sur Cmd/Ctrl + P pour ouvrir la palette de commandes. Cherchez "Copilot" pour voir les actions rapides.
  • Vault QA (Mode RAG) : Pour discuter avec l'intégralité de votre base de connaissances, passez le mode de chat de "Chat" à "Vault QA". Cliquez sur Index Vault. Copilot générera des embeddings locaux de vos fichiers markdown, vous permettant de poser des questions sémantiques sur toutes vos notes.

Obsidian Git

Le plugin Git permet un accès à distance à votre coffre-fort. En hébergeant votre dépôt Git de manière privée (comme sur GitHub ou GitLab) ou sur votre propre serveur, vos données restent stockées en toute sécurité et gratuitement.

Il fournit une interface Git complète directement dans Obsidian. Vous disposez de boutons dédiés et de raccourcis (Cmd/Ctrl + P) pour récupérer (fetch), tirer (pull), valider (commit) et pousser (push) les modifications. Il inclut une protection intégrée contre les conflits de fusion et la possibilité de synchroniser automatiquement.

Avec ce plugin, vous pouvez accéder à vos données sur n'importe quel appareil. La configuration ne nécessite que des compétences Git de base. Comme Obsidian est disponible sur iOS et Android, vous pouvez accéder et mettre à jour votre coffre-fort distant depuis votre mobile.

Configurer le Coffre-fort Distant

Prérequis

  1. Git Installé : Assurez-vous que Git est installé sur votre ordinateur.
  2. Compte Distant : Ayez un compte sur un service d'hébergement Git (comme GitHub, GitLab, ou Bitbucket).

Étape 1 : Initialiser Git dans Votre Coffre-fort Local

  1. Naviguez vers votre coffre-fort dans le terminal : cd /chemin/vers/votre/coffre-fort/obsidian
  2. Initialisez le dépôt Git : git init
  3. Ajoutez tous vos fichiers : git add .
  4. Créez votre premier commit : git commit -m "Commit initial du coffre-fort"
  5. Renommez la branche par défaut en main : git branch -M main

Étape 2 : Créer un Dépôt Distant

  1. Allez sur votre fournisseur Git et créez un Nouveau Dépôt (New Repository).
  2. Nommez-le (ex: mon-coffre-fort-obsidian).
  3. Gardez-le Privé (Private).
  4. Important : Ne l'initialisez pas avec un README, .gitignore, ou une licence. Vous voulez un dépôt vide.
  5. Copiez l'URL du dépôt distant.

Étape 3 : Lier et Pousser vers le Distant

  1. Liez votre coffre-fort local : git remote add origin <collez-votre-URL-de-depot-ici>
  2. Poussez vos fichiers locaux : git push -u origin main

Étape 4 : Configurer le Plugin Obsidian Git

  1. Ouvrez Obsidian et allez dans les Paramètres.
  2. Allez dans Plugins communautaires et désactivez le "Safe mode" si ce n'est pas fait.
  3. Cherchez et installez Obsidian Git. Activez-le.
  4. Dans les paramètres d'Obsidian Git :
    • Réglez Vault backup interval à votre fréquence préférée (ex: 30 ou 60).
    • Activez Auto pull on start.
Configurer l'Accès Mobile

Note : Ce guide couvre Android et iOS, bien que seule la méthode Android ait été vérifiée. La fonction de clonage intégrée dans le plugin mobile est souvent instable. Pour contourner cela, nous allons transférer un dépôt déjà cloné de votre ordinateur vers votre téléphone.

Étape 1 : Préparer le Coffre-fort Local sur Votre PC

  1. Ouvrez votre terminal dans votre coffre-fort.
  2. Vérifiez votre URL distante : git remote -v
  3. Si elle commence par git@ (SSH), changez-la en HTTPS : git remote set-url origin https://github.com/UTILISATEUR/DEPOT.git
  4. Zippez l'intégralité de votre dossier de coffre-fort, en incluant les dossiers cachés (.git et .obsidian).

Étape 2 : Transférer le Coffre-fort sur Votre Téléphone

  1. Android : Connectez votre téléphone et copiez le fichier ZIP dans votre stockage interne, puis dézippez-le.
  2. iOS : Transférez via iCloud Drive ou AirDrop dans Sur mon iPhone -> Obsidian, puis dézippez.

Étape 3 : Générer un Personal Access Token (PAT)

Les claviers mobiles gèrent mal l'authentification Git standard. Vous avez besoin d'un token.

  1. Allez sur votre fournisseur Git (ex: GitHub).
  2. Naviguez vers Settings > Developer Settings > Personal Access Tokens.
  3. Générez un nouveau token avec les permissions de lecture et d'écriture (repo).
  4. Copiez ce token.

Étape 4 : Ouvrir le Coffre-fort dans Obsidian Mobile

  1. Ouvrez l'application Obsidian sur votre téléphone.
  2. Appuyez sur Open folder as vault.
  3. Naviguez vers le dossier dézippé. Acceptez de faire confiance à l'auteur si demandé.

Étape 5 : S'authentifier et Synchroniser

  1. Ouvrez la Palette de commandes.
  2. Sélectionnez Obsidian Git: Pull.
  3. Entrez vos identifiants :
    • Username : Votre nom d'utilisateur GitHub/GitLab.
    • Password : Le Personal Access Token généré à l'étape 3.
  4. Exécutez Obsidian Git: Commit all changes and push pour vérifier la synchronisation.

Autres Plugins Notables

  • Kanban : Un excellent ajout pour créer des tableaux kanban personnalisés et suivre vos tâches.
  • Excalidraw : Créez des figures Excalidraw localement avec une intégration parfaite dans vos notes.
  • Outliner : Un outil puissant qui apporte une expérience de plan (outliner) type Workflowy à Obsidian.
  • LanguageTool : Intègre le moteur LanguageTool pour fournir une correction en temps réel (grammaire, syntaxe, orthographe) directement dans votre éditeur.
  • Dataview : Un moteur de requête en direct qui transforme votre coffre-fort en une base de données dynamique. En ajoutant de simples métadonnées, vous pouvez générer automatiquement des tableaux, des listes et des tableaux de bord.

La plupart des plugins sont complètement compatibles avec l'expérience utilisateur mobile.

Type to start searching...