Guide obsidian

Mis à jour le samedi 17 septembre 2022 par johackim

Obsidian est une application de prise de notes comme Evernote, Notion et Bear, mais se distingue en introduisant une nouvelle façon d'organiser et de prendre vos notes.

  • Les Backlinks (liens bidirectionnels) - permettant de relier les notes entre elles.
  • Un Graph Viewer - pour découvrir et associer des notes et des topics.

Et contrairement à Roam Research, Obsidian est gratuit et garde les données en local sur son ordinateur.

Ainsi, vous pouvez sauvegarder/synchroniser toutes vos données sur votre NAS ou une solution cloud comme Nextcloud.

Il est disponible sur Mac, Windows, Linux, Android et iOS.

Syntaxe d'Obsidian

Obsidian utilise la syntaxe Markdown par défaut avec quelques spécificités supplémentaires :

  • [[Linking Note]] : Créer un lien vers une autre note
  • [[Linking Note|Link Name]] : Créer un lien avec un nom personnalisé
  • [[Linking Note#heading]] : Créer un lien vers un titre d'une autre note
  • ![[Linking Note^]] : Intégrer un bloc d'une autre note
  • ![[Filename]] : Intégrer une autre note
  • !250 : Insérer une image embed de 250px de largeur

  • ![|250](https://site.xyz/image.png) : Insérer une image de 250px de largeur
  • #tag : Créer un tag
  • #nested/tag : Créer un sous-tag
  • [^Ref] et [^Ref]: Footnote text. : Créer une note de bas de page
  • ^[Footnote text] : Créer une note de bas de page en une ligne
  • ==highlight== : Créer un texte surligné
  • aliases: [Alias1, Alias2] : Créer un alias (à ajouter dans le frontmatter)
  • - [ ] Task list : Créer une tâche
  • - [x] Task list : Cochez une tâche

Raccourcis clavier

  • CTRL+E : Basculer entre le mode édition et visualisation.
  • CTRL+O : Changer de fichier rapidement
  • CTRL+MAJ+F : Activer le mode recherche
  • CTRL+P : Exécuter une commande
  • CTRL+G : Afficher le Graph viewer
  • CTRL+, : Afficher les paramètres d'Obsidian

Fonctionnalités avancées

  • Mermaid : Obsidian est compatible avec Mermaid, ce qui vous permet de créer des diagrammes dans vos notes.
  • Workspaces : Vous pouvez créer des espaces de travail avec des configurations différentes.
  • Templates : Vous pouvez créer des templates réutilisables.
  • Daily notes : Obsidian permet de créer rapidement des notes journalières à partir d'un template.
  • Publish : Vous pouvez publier vos notes publiquement sur un site que obsidian.md héberge pour vous.

Plugins

Obsidian offre la possibilité d'étendre ses fonctionnalités avec des plugins :

PluginDescrition
MindmapCréer des mindmaps
KanbanCréer des boards kanban
Avanced-tablesSimplifier l'édition des tableaux
Note-refactorSéparer une note en plusieurs notes
TrackerCollecter des données à afficher des graphiques
FlashcardsCréer des Flashcards
Andy Matuschak ModeActiver le mode d'affichage Andy Matuschak
Obsidian ChartsCréer des graphiques
DataviewCréer des tableaux basées sur ses notes
TasksGérer ses tâches
TocCréer automatiquement un sommaire
Tag-wranglerAméliorer la gestion des tags
ExcalidrawDessiner sur Obsidian
Heatmap calendarAfficher un calendrier comme Github Activity
Hover EditorAméliorer le mode prévisualisation des liens
Alternative CheckboxesDesign pour améliorer les checkboxes
Obsidian linterLinter markdown

Créer un thème Obsidian

Voici un tutoriel pour créer un thème Obsidian.

Créer un fichier.css

Créer un fichier CSS nomdutheme.css dans le dossier .obsidian/themes de votre Vault Obsidian.

Ce fichier contient simplement les couleurs (en valeur hexadécimale) des éléments de votre thème (texte, blocs de code, fonds, etc...).

Vous pouvez vous inspirer de mon thème qui va overrider le thème light et dark par défaut d'Obsidian :

/* vault/.obsidian/themes/darkyan.css */
.theme-light,
.theme-dark {
--background-primary: #111827;
--background-primary-alt: #111827;
--background-secondary: #1F2937;
--background-secondary-alt: #1F2937;
--text-normal: #D1D5DB;
--text-faint: #D1D5DB;
--text-title-h1: #D1D5DB;
--text-title-h2: #D1D5DB;
--text-title-h3: #D1D5DB;
--text-title-h4: #D1D5DB;
--text-title-h5: #D1D5DB;
--text-title-h6: #D1D5DB;
--text-highlight-bg: #374151;
--text-link: #D1D5DB;
--text-a-hover: #D1D5DB;
--inline-code: #D1D5DB;
--code-block: #D1D5DB;
--text-a: #D1D5DB;
--interactive-accent: #00AAAD;
--text-accent: #00AAAD;
--text-accent-hover: #00AAAD;
--text-on-accent: #D1D5DB;
--interactive-accent-rgb: #D1D5DB;
--interactive-accent-hover: #00AAAD;
--vim-cursor: #D1D5DB;
--pre-code: #000000;
--interactive-before: #374151;
--background-modifier-border: #374151;
--text-selection: #374151;
--text-faint: #4B5563;
}

Activer le thème

Une fois le fichier créé, vous pouvez activer votre thème depuis les paramètres dans le menu suivant :

Settings -> Appearance -> Themes -> Theme -> NomDeVotreTheme

Publier un thème

J'ai récemment créé un thème, vous pouvez l'utiliser en vous rendant sur le dépôt Github johackim/obsidian-darkyan.

Pour publier son thème dans les thèmes de la communauté d'Obsidian, créez une pull request sur le dépôt obsidianmd/obsidian-releases.

Une fois la pull request accepté, il apparaitra dans la liste des thèmes d'Obsidian dans Settings -> Appearance -> Themes -> Community themes.

Sécurité

D'un point de vue sécurité, voilà ce qui est affiché sur la page d'accueil d'Obsidian :

À notre époque où les services de cloud computing peuvent fermer, être rachetés ou changer de politique de confidentialité à tout moment, la dernière chose que vous voulez est un format propriétaire et un verrouillage des données.
Avec Obsidian, vos données se trouvent dans un dossier local. Ne laissez plus jamais le travail de votre vie pris en otage dans le cloud.
Le format Markdown en texte brut vous donne également une interopérabilité inégalée pour utiliser n'importe quel type de synchronisation, de chiffrage ou de traitement de données qui fonctionne avec des fichiers en texte brut.

Et lorsque vous activez la fonctionnalité Sync, les données sont chiffrées de bout en bout par défaut.

Plus d'informations

Astuces

Pour avoir la liste de nos notes ordonnées par date, faites une recherche (CTRL+MAJ+F) avec la valeur path:/ et en cliquant sur ordonner par date de création.


Références :