Introduction à Obsidian

Obsidian est un logiciel de prise de notes à liens bidirectionnels basé sur des fichiers Markdown locaux. Officiellement positionné comme votre second cerveau (Un second cerveau, pour vous, pour toujours), il peut vous aider à tisser des points de connaissance dispersés en un réseau de connaissances évolutif.

Obsidian est un outil de gestion des connaissances personnelleslocal-first.

Le format de fichier principal d'Obsidian est Markdown en texte brut. Toutes les notes sont stockées en tant que fichiers.mddans des dossiers locaux sur votre ordinateur.

Contrairement aux outils de notes en ligne tels que Notion et Yuque, Obsidian ne nécessite pas d'accès à Internet ; vos données sont entièrement entre vos mains.

Comparé aux outils de notes de style outliner comme Roam Research et Logseq, Obsidian est plus proche de l'expérience traditionnelle d'édition de documents, permettant d'écrire librement tout en conservant de puissantes capacités de liaison bidirectionnelle.

Obsidian est aux notes ce que VS Code est à l'édition de code : non pas une plateforme fermée, mais un outil infiniment extensible. Et comme tout votre contenu est stocké sous forme de fichiers en texte brut, vous en serez toujours propriétaire.

Pourquoi choisir Obsidian

FonctionnalitéObsidianNotionRoam Research
Méthode de stockageFichiers Markdown locauxBase de données cloudBase de données cloud
Disponibilité hors ligneEntièrement hors ligneNécessite un préchargementNécessite Internet
Capacité de liaison bidirectionnellePrise en charge nativePrise en charge limitéePrise en charge native (style outliner)
Extensibilité1000+ plugins communautairesPeu d'intégrationsMoins de plugins
PrixGratuit pour un usage personnelFreemiumAbonnement payant
Migration des donnéesIl suffit de copier le dossierNécessite une exportationNécessite une exportation

L'essence même d'Obsidian peut se résumer en trois points :

  1. Stockage en texte brut: Toutes les notes sont des fichiers Markdown.mdau format texte brut, stockés dans un dossier sur votre ordinateur local. Aucun format propriétaire, aucune base de données ; n'importe quel éditeur de texte peut les ouvrir.
  2. Liens bidirectionnels: Les notes peuvent se référencer mutuellement, formant un réseau de connaissances plutôt que des fichiers isolés.
  3. Extensibilité: Avec plus de 1,500 plugins communautaires, vous pouvez transformer Obsidian en la forme dont vous avez besoin.

Pourquoi Obsidian est particulièrement adapté aux développeurs

De nombreux outils peuvent « prendre des notes », mais Obsidian présente plusieurs attraits uniques pour les développeurs.

Markdown est votre langue maternelle

En tant que développeur, vous rédigez des READMEs, de la documentation et des commentaires chaque jour.

Markdown fait déjà partie de votre travail. Obsidian traite Markdown comme un citoyen de première classe, donc il n'y a aucune courbe d'apprentissage.

Des fichiers locaux, compatibles avec Git

Tous les fichiers sont en texte brut, ce qui signifie :

  • Vous pouvez utilisergit initpour le contrôle de version de l'ensemble de votre coffre.
  • Vous pouvez utilisergrep、sedet des scripts pour traiter les notes par lots.
  • Migration, sauvegarde et export sans aucun obstacle.
  • Vos données ne vous seront jamais retirées par l'effondrement d'une entreprise.

La mentalité de programmeur s'aligne parfaitement avec Obsidian

Habitude de développeurFonctionnalité correspondante d'Obsidian
Fonctions/modules se référençant mutuellementLiens bidirectionnels[[]]
Écrire des commentaires et de la documentation pour le codeBlocs de code intégrés dans les notes
Suivi des modifications avec GitTexte brut + gestion de versions avec Git
Gestion des tâches avec des tags/branchesSystème de tags + structure de dossiers
Consulter la documentation de l'APIBase de connaissances personnelle + recherche rapide
README du projetNotes du projet + tableau blanc Canvas

Différences principales par rapport aux outils grand public

Avant de choisir un outil, vous devez comprendre le positionnement de chacun pour éviter toute construction redondante.

Obsidian vs Notion

Critère de comparaisonObsidianNotion
Stockage de donnéesFichiers en texte brut locauxServeurs Notion (cloud)
Disponibilité hors ligneEntièrement hors ligneNécessite une connexion réseau
Propriété des donnéesVous en êtes entièrement propriétaireHébergé par la société Notion
VitesseExtrêmement rapide, réponse de l'ordre de la millisecondeDépend de la vitesse du réseau, ralentissements occasionnels
Fonctionnalités de collaborationFaibles (nécessite des outils tiers)Fortes (prend naturellement en charge la collaboration multi-utilisateur)
Degré de personnalisationExtrêmement élevé (écosystème riche de plugins)Moyenne
Scénarios adaptésGestion des connaissances personnelles, réflexion approfondieCollaboration d'équipe, gestion de projet
Courbe d'apprentissageMoyenneFaible

Conclusion : Si vous devez collaborer avec une équipe, Notion est plus adapté. Si vous devez construire un système de connaissances personnel et à long terme, Obsidian est le meilleur choix.

Les deux ne s'excluent pas mutuellement ; beaucoup de personnes utilisent les deux simultanément.

Obsidian vs Roam Research

Roam Research est le pionnier de la prise de notes par liens bidirectionnels, mais Obsidian est le choix le plus pratique :

  • Roam est un abonnement SaaS ($15/month), tandis qu'Obsidian est entièrement gratuit pour un usage personnel.
  • Roam stocke les données dans le cloud, Obsidian stocke les données localement.
  • La structure de type outliner de Roam est meilleure pour la pensée divergente, tandis que la structure de type document d'Obsidian est meilleure pour la consolidation et l'organisation.

Obsidian vs Typora / VS Code

Ces outils peuvent aussi écrire du Markdown, mais il leur manque les capacités essentielles d'Obsidian :

  • Pas de liens bidirectionnels: les fichiers sont isolés les uns des autres et ne peuvent pas former un réseau de connaissances.
  • Pas de vue graphique: impossible de voir visuellement les relations entre les connaissances.
  • Pas d'écosystème de plugins: impossible d'étendre les fonctionnalités à la demande.

Typora est un excellent éditeur Markdown, et VS Code est un excellent éditeur de code, mais aucun des deux n’est un outil de gestion des connaissances.


La philosophie fondamentale d’Obsidian

Avant d’installer, établir quelques modèles mentaux de base rendra l’apprentissage ultérieur deux fois plus efficace pour deux fois moins d’effort.

Principe 1 : Les notes sont des fichiers

Obsidian n’a ni base de données ni format propriétaire qui lui soit propre.

Chaque note est un fichier.mdsur votre disque dur.

~/Documents/MyVault/
├── 日记/
│   ├── 2024-01-15.md
│   └── 2024-01-16.md
├── 技术笔记/
│   ├── Git 常用命令.md
│   └── Docker 入门.md
└── 读书笔记/
    └── 深入理解计算机系统.md

Lorsque vous créez une note dans Obsidian, vous créez en réalité un fichier Markdown dans un dossier.

Vous pouvez le voir directement dans l’explorateur de fichiers, et utiliser des commandescatpour le lire, et Git pour le suivre.

Principe 2 : Les liens comptent plus que les dossiers

Les logiciels de prise de notes traditionnels s’appuient sur des dossiers pour organiser le contenu, comme ranger des livres dans différents tiroirs.

Cette approche a un défaut fatal :Un élément de connaissance ne peut appartenir qu’à un seul tiroir.。

L’idée centrale d’Obsidian est : plutôt que de mettre les notes dans des catégories, les relier entre elles.

# Docker 入门

Docker 是一种容器化技术,与 [[虚拟机]] 的关键区别在于...
在部署时,通常配合 [[Kubernetes]] 使用...
学习 Docker 之前建议先了解 [[Linux 基础]]...

Lorsque vous ouvrez la note « Premiers pas avec Docker », vous verrez qu’elle renvoie à trois notes : « Machine virtuelle », « Kubernetes » et « Bases de Linux ».

En même temps, la note « Bases de Linux » affichera aussi que « une note appelée Premiers pas avec Docker me référence. »

C’estle lien bidirectionnel, qui simule la façon dont les concepts sont associés dans le cerveau humain.

Principe 3 : Le graphe de connaissances est l’effet, pas la cause

Beaucoup de débutants voient le magnifique graphe de connaissances d’Obsidian et pensent à tort que « construire un graphe de connaissances » est le but d’utiliser Obsidian.

Ensuite, ils passent beaucoup de temps à concevoir des structures sans réellement prendre de notes.

La bonne compréhension est la suivante :le graphe est un sous-produit qui se développe naturellement après que vous prenez des notes et créez des liens,pas quelque chose que vous devez concevoir soigneusement dès le départ.

Prenez d’abord des notes, créez d’abord des liens, et le graphe deviendra naturellement riche.

Principe 4 : Ne courez jamais après un système parfait

C’est le piège dans lequel les débutants tombent le plus facilement : passer trop de temps à concevoir la structure de dossiers et le système d’étiquettes « parfaits », plutôt qu’à réellement enregistrer et réfléchir.

Un système « suffisamment bon » utilisé de manière constante est bien meilleur qu’un système « parfait » qui n’a jamais vraiment été mis en œuvre.

Autres extensions