Compétence Obsidian Flavored Markdown

Créer et éditer du Markdown Obsidian valide. Obsidian étend CommonMark et GFM avec les wikilinks, les embeds, les callouts, les propriétés, les commentaires et d'autres syntaxes. Cette compétence couvre uniquement les extensions spécifiques à Obsidian -- le Markdown standard (titres, gras, italique, listes, citations, blocs de code, tableaux) est supposé connu.

Workflow : Créer une note Obsidian

Ajouter le frontmatter avec les propriétés (titre, tags, aliases) en haut du fichier. Voir PROPERTIES.md pour tous les types de propriétés.
Rédiger le contenu en utilisant le Markdown standard pour la structure, plus la syntaxe spécifique à Obsidian ci-dessous.
Lier les notes connexes en utilisant des wikilinks ([[Note]]) pour les connexions internes au vault, ou des liens Markdown standard pour les URLs externes.
Intégrer du contenu depuis d'autres notes, des images ou des PDF en utilisant la syntaxe ![[embed]]. Voir EMBEDS.md pour tous les types d'embeds.
Ajouter des callouts pour les informations en évidence en utilisant la syntaxe > [!type]. Voir CALLOUTS.md pour tous les types de callouts.
Vérifier que la note s'affiche correctement en mode lecture d'Obsidian.

Quand choisir entre wikilinks et liens Markdown : utilisez [[wikilinks]] pour les notes du vault (Obsidian suit automatiquement les renommages) et [texte](url) uniquement pour les URLs externes.

Liens internes (Wikilinks)

[[Note Name]]                          Lien vers une note
[[Note Name|Display Text]]             Texte d'affichage personnalisé
[[Note Name#Heading]]                  Lien vers un titre
[[Note Name#^block-id]]                Lien vers un bloc
[[#Heading in same note]]              Lien vers un titre dans la même note

Définissez un ID de bloc en ajoutant ^block-id à n'importe quel paragraphe :

Ce paragraphe peut être lié. ^my-block-id

Pour les listes et citations, placez l'ID du bloc sur une ligne séparée après le bloc :

> Un bloc de citation

^quote-id

Embeds

Préfixez n'importe quel wikilink avec ! pour intégrer son contenu en ligne :

![[Note Name]]                         Intégrer la note entière
![[Note Name#Heading]]                 Intégrer une section
![[image.png]]                         Intégrer une image
![[image.png|300]]                     Intégrer une image avec largeur
![[document.pdf#page=3]]               Intégrer une page PDF

Voir EMBEDS.md pour les embeds audio, vidéo, recherche et images externes.

Callouts

> [!note]
> Callout basique.

> [!warning] Titre personnalisé
> Callout avec un titre personnalisé.

> [!faq]- Replié par défaut
> Callout repliable (- replié, + déplié).

Types courants : note, tip, warning, info, example, quote, bug, danger, success, failure, question, abstract, todo.

Voir CALLOUTS.md pour la liste complète avec les alias, l'imbrication et les callouts CSS personnalisés.

Propriétés (Frontmatter)

---
title: My Note
date: 2024-01-15
tags:
  - project
  - active
aliases:
  - Alternative Name
cssclasses:
  - custom-class
---

Propriétés par défaut : tags (labels recherchables), aliases (noms alternatifs pour les suggestions de liens), cssclasses (classes CSS pour le style).

Voir PROPERTIES.md pour tous les types de propriétés, les règles de syntaxe des tags et l'utilisation avancée.

Commentaires

Ceci est visible %%mais ceci est caché%% du texte.

%%
Ce bloc entier est caché en mode lecture.
%%

Formatage spécifique à Obsidian

==Texte en surbrillance==               Syntaxe de surbrillance

Math (LaTeX)

Inline : $e^{i\pi} + 1 = 0$

Bloc :
$$
\frac{a}{b} = c
$$

Diagrammes (Mermaid)

```mermaid
graph TD
    A[Start] --> B{Decision}
    B -->|Yes| C[Do this]
    B -->|No| D[Do that]
```

Pour lier les nœuds Mermaid aux notes Obsidian, ajoutez class NodeName internal-link;.

Notes de bas de page

Texte avec une note de bas de page[^1].

[^1]: Contenu de la note de bas de page.

Note de bas de page inline.^[Ceci est inline.]

Exemple complet

---
title: Project Alpha
date: 2024-01-15
tags:
  - project
  - active
status: in-progress
---

# Project Alpha

Ce projet vise à [[improve workflow]] en utilisant des techniques modernes.

> [!important] Date limite clé
> Le premier jalon est dû le ==30 janvier==.

## Tasks

- [x] Planification initiale
- [ ] Phase de développement
  - [ ] Implémentation du backend
  - [ ] Design du frontend

## Notes

L'algorithme utilise le tri $O(n \log n)$. Voir [[Algorithm Notes#Sorting]] pour les détails.

![[Architecture Diagram.png|600]]

Examiné dans [[Meeting Notes 2024-01-10#Decisions]].

obsidian-markdown