O03 - Obsidian : bien utiliser ce vault
Objectif
Installer Obsidian, comprendre l’organisation de ce vault, et maîtriser la syntaxe utilisée dans toute la doc : liens “, callouts, Mermaid, maths LaTeX, intégration de SVG.
1. Installation
| Méthode | Commande | Remarque |
|---|---|---|
| Flatpak (Pop!_OS, Arch) | flatpak install flathub md.obsidian.Obsidian | Si le vault est hors du dossier personnel : flatpak override --user md.obsidian.Obsidian --filesystem=/chemin |
| AppImage officielle | Télécharger sur obsidian.md, chmod +x Obsidian-*.AppImage | Nécessite libfuse2 (Pop!_OS) / fuse2 (Arch) |
.deb officiel | sudo apt install ./obsidian_*.deb | Pop!_OS |
| Arch | sudo pacman -S obsidian | Dépôt officiel extra |
2. Organisation de ce vault
flowchart TB V["📁 truc non trier (vault)"] --> CS["📁 cours_save<br/>cours d'origine (PDF, .md, .pkt…)"] V --> D["📁 doc<br/>documentation par thème"] V --> S["📁 scripts<br/>scripts prêts à l'emploi"] D --> I["00-Accueil → 00 - Index général"] D --> T["01-Réseaux … 11-Logiciels-et-outils"] D --> P["12-Pas-encore-vu"] D --> SC["_schemas (SVG)"]
Règles : cours_save/ = sources d’origine (on n’y touche pas) ; doc/ = fiches rédigées (préfixe R, S, L, W, ST, V, B, SV, M, C, O, P) ; scripts/ = code exécutable, aussi recopié dans les fiches.
3. Syntaxe utilisée dans la doc
| Élément | Syntaxe |
|---|---|
| Lien vers une note | [[R04 - Sous-réseaux et VLSM]] ; avec un autre texte : VLSM ; vers un titre : [[R04 - Sous-réseaux et VLSM\#4. VLSM]] |
| Intégrer une note / une image / un SVG | ![[architecture-3-tiers.svg]] |
| Callout | > [!tip] Titre (types : note, tip, warning, danger, info, success, example, bug, abstract) ; repliable : > [!success]- Correction |
| Maths | $x^2$ en ligne, $$ … $$ en bloc (LaTeX/MathJax) |
| Diagramme | bloc de code ```mermaid (flowchart, sequenceDiagram, classDiagram, erDiagram, stateDiagram-v2, gantt, mindmap) |
| Métadonnées | Bloc YAML --- en haut (tags, statut, source) |
| Tags | #reseau ou dans le YAML tags: [reseau] |
4. Raccourcis
| Raccourci | Effet |
|---|---|
Ctrl+O | Ouvrir une note (recherche rapide) |
Ctrl+P | Palette de commandes |
Ctrl+Maj+F | Rechercher dans tout le vault |
Ctrl+E | Basculer édition / lecture |
Ctrl+clic sur un lien | Ouvrir dans un nouvel onglet |
Ctrl+G | Vue graphe (liens entre notes) |
5. Plugins utiles
| Plugin | Usage |
|---|---|
| Git (Vinzent) | Synchroniser le vault avec un dépôt Git (c’est ce qu’il y a derrière ton Ctrl+Maj+U pour récupérer le cours d’Alan) |
| Excalidraw | Schémas dessinés à la main |
| Dataview | Requêtes sur les notes (ex. lister les fiches « pas encore vu ») |
| Advanced Tables | Édition confortable des tableaux Markdown |
Exemple Dataview (si le plugin est installé) :
```dataview
TABLE statut, theme FROM "doc" SORT file.name ASC
```
6. Synchronisation
- pCloud (ton cas) : le vault dans un dossier synchronisé → attention aux conflits si Obsidian est ouvert sur deux appareils en même temps.
- Git : historique complet des modifications, idéal aussi pour les scripts → O04 - Git et GitHub.
- Obsidian Sync (payant), Syncthing (libre, pair à pair, mobile Android compris).
- Exporter une note en PDF : menu
⋯→ Exporter en PDF (pratique pour les rendus).