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é | Obsidian | Notion | Roam Research |
|---|---|---|---|
| Méthode de stockage | Fichiers Markdown locaux | Base de données cloud | Base de données cloud |
| Disponibilité hors ligne | Entièrement hors ligne | Nécessite un préchargement | Nécessite Internet |
| Capacité de liaison bidirectionnelle | Prise en charge native | Prise en charge limitée | Prise en charge native (style outliner) |
| Extensibilité | 1000+ plugins communautaires | Peu d'intégrations | Moins de plugins |
| Prix | Gratuit pour un usage personnel | Freemium | Abonnement payant |
| Migration des données | Il suffit de copier le dossier | Nécessite une exportation | Nécessite une exportation |
L'essence même d'Obsidian peut se résumer en trois points :
- 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.
- Liens bidirectionnels: Les notes peuvent se référencer mutuellement, formant un réseau de connaissances plutôt que des fichiers isolés.
- 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éveloppeur | Fonctionnalité correspondante d'Obsidian |
|---|---|
| Fonctions/modules se référençant mutuellement | Liens bidirectionnels[[]] |
| Écrire des commentaires et de la documentation pour le code | Blocs de code intégrés dans les notes |
| Suivi des modifications avec Git | Texte brut + gestion de versions avec Git |
| Gestion des tâches avec des tags/branches | Système de tags + structure de dossiers |
| Consulter la documentation de l'API | Base de connaissances personnelle + recherche rapide |
| README du projet | Notes 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 comparaison | Obsidian | Notion |
|---|---|---|
| Stockage de données | Fichiers en texte brut locaux | Serveurs Notion (cloud) |
| Disponibilité hors ligne | Entièrement hors ligne | Nécessite une connexion réseau |
| Propriété des données | Vous en êtes entièrement propriétaire | Hébergé par la société Notion |
| Vitesse | Extrêmement rapide, réponse de l'ordre de la milliseconde | Dépend de la vitesse du réseau, ralentissements occasionnels |
| Fonctionnalités de collaboration | Faibles (nécessite des outils tiers) | Fortes (prend naturellement en charge la collaboration multi-utilisateur) |
| Degré de personnalisation | Extrêmement élevé (écosystème riche de plugins) | Moyenne |
| Scénarios adaptés | Gestion des connaissances personnelles, réflexion approfondie | Collaboration d'équipe, gestion de projet |
| Courbe d'apprentissage | Moyenne | Faible |
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.
Autres extensionsUn 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.