Aide-mémoire Markdown Obsidian

Utilisez cette page comme référence à copier-coller pour le Markdown que vous utilisez le plus dans Obsidian. Elle couvre le Markdown standard, les extensions propres à Obsidian comme les wikilinks et les callouts, ainsi que les raccourcis qui vous aident à éditer vos notes rapidement.

Obsidian repose sur CommonMark et GitHub-Flavored Markdown, puis ajoute des fonctionnalités pour les notes interconnectées : [[wikilinks]], ![[intégrations]], callouts, surlignages, commentaires, références de bloc et propriétés. Le Markdown standard est généralement l’option la plus portable ; la syntaxe Obsidian est le meilleur choix lorsque la note est destinée à fonctionner au sein de votre coffre (vault).

Référence rapide

Besoin	Syntaxe	Exemple
Titre	# à ######	## Notes de projet
Gras	**texte**	**important**
Italique	*texte*	*optionnel*
Barré	~~texte~~	~~ancien plan~~
Surligné	==texte==	==décision==
Lien externe	[intitulé](url)	[Aide Obsidian](https://obsidian.md/help)
Lien interne	[[Note]]	[[Brief du projet]]
Tâche	- [ ]	- [ ] Envoyer le suivi
Callout	> [!type]	> [!tip] Essayez ce workflow
Intégration de note	![[Note]]	![[Notes de réunion]]
Code en ligne	`code`	`status: brouillon`
Commentaire	%%texte%%	%%Visible uniquement en édition%%

Formatage du texte et structure

# Titre 1
## Titre 2
### Titre 3

**Texte en gras**
*Texte en italique* ou _texte en italique_
***Texte en gras et italique***
~~Texte barré~~
==Texte surligné==

> Une citation en bloc peut contenir un extrait utile ou un rappel.

---

Utilisez une ligne vide pour commencer un nouveau paragraphe. Un simple Entrée dans un paragraphe est normalement traité comme un saut de ligne doux. Pour un saut de ligne strict, utilisez Maj+Entrée ou ajoutez deux espaces avant d’appuyer sur Entrée. Si vous avez besoin d’un comportement compatible Markdown entre plusieurs éditeurs, cochez Paramètres → Éditeur → Sauts de ligne stricts.

Pour afficher des caractères Markdown littéralement, échappez-les avec un antislash :

\*Ceci n'est pas en italique\*
1\. Ceci n'est pas un élément de liste
\# Ceci n'est pas un titre

Listes, listes de tâches et imbrication

- Premier élément
- Deuxième élément
  - Élément imbriqué

1. Première étape
2. Deuxième étape

- [ ] Tâche ouverte
- [x] Tâche terminée
  - [ ] Sous-tâche

En mode Lecture, vous pouvez cliquer sur la case à cocher d’une tâche pour basculer son état. Pour les dates d’échéance, les tâches récurrentes et les requêtes à travers plusieurs notes, consultez le guide complet de la gestion des tâches dans Obsidian.

Liens et intégrations

Liens internes

[[Nom de la note]]
[[Nom de la note|Texte affiché]]
[[Nom de la note#Titre]]
[[Nom de la note#Titre|Texte affiché]]
[[Nom de la note#^block-id]]

[[Nom de la note]] pointe vers une autre note du coffre. Ajoutez | pour un alias, # pour un titre ou #^ pour une référence de bloc. Utilisez le préfixe ! pour intégrer au lieu de simplement lier :

![[Nom de la note]]
![[Nom de la note#Titre]]
![[Nom de la note#^block-id]]
![[image.png]]
![[image.png|400]]

Les intégrations sont utiles lorsqu’une définition réutilisable, une décision de réunion ou une liste de contrôle doit apparaître à plusieurs endroits tout en restant éditable dans une seule note source.

Liens externes et images

[Aide Obsidian](https://obsidian.md/help)
![Description](https://example.com/image.png)

Utilisez un texte de lien descriptif. Pour les notes susceptibles de quitter votre coffre, les liens Markdown standard sont plus portables que les wikilinks.

Tableaux

Un tableau nécessite une ligne d’en-tête et une ligne délimitatrice. Chaque cellule délimitatrice nécessite au moins deux tirets :

| Statut | Action suivante |
| --- | --- |
| Ouvert | Réviser aujourd'hui |
| Terminé | Archiver la note |

Alignez les colonnes avec des deux-points dans la ligne délimitatrice :

| Gauche | Centre | Droite |
| :--- | :---: | ---: |
| A | B | C |

En Prévisualisation en direct, utilisez le menu contextuel du tableau ou la commande Insérer un tableau pour ajouter des lignes et des colonnes. Si un tableau ne s’affiche pas, vérifiez ces causes courantes :

• Ajoutez une ligne vide avant le tableau.
• Conservez la ligne délimitatrice directement sous l’en-tête.
• Échappez une barre verticale littérale à l’intérieur d’une cellule sous la forme \|.
• Évitez les blocs de code multilignes dans les cellules de tableau ; utilisez une note liée ou intégrée lorsque l’exemple nécessite plus d’une ligne.

Encadrés (Callouts)

Les callouts sont des citations en bloc stylisées. L’identifiant de type contrôle l’icône et la couleur ; le titre est optionnel.

> [!tip] Un titre court
> Gardez le conseil près du paragraphe qu'il explique.

> [!warning]- Un avertissement replié
> Ce contenu commence replié.

Les types intégrés courants incluent note, abstract, info, todo, tip, success, question, warning, failure, danger, bug, example et quote. Le suffixe + démarre un callout déplié ; le suffixe - le démarre replié. Consultez le guide complet des callouts Obsidian pour le CSS personnalisé et le dépannage.

Code, notes de bas de page, commentaires et mathématiques

Utilisez un simple backtick pour le code en ligne et trois backticks pour un bloc de code. Ajoutez un identifiant de langage pour la coloration syntaxique :

Utilisez `Ctrl+P` pour ouvrir la palette de commandes.

```js
const noteType = "project";
```

Les notes de bas de page utilisent une référence et une définition :

Obsidian stocke les notes sous forme de fichiers Markdown.[^1]

[^1]: Confirmez le comportement dans la documentation d'aide officielle d'Obsidian.

Les commentaires sont masqués en mode Lecture et sur Obsidian Publish :

Texte visible %%rappel uniquement pour l'éditeur%%

Pour les mathématiques, utilisez un simple signe dollar pour les expressions en ligne et un double signe dollar pour un bloc :

En ligne : $a^2 + b^2 = c^2$

$$
\int_0^1 x^2 dx = \frac{1}{3}
$$

Raccourcis à retenir

Voici des valeurs par défaut utiles, qui ne remplacent pas votre propre configuration de raccourcis :

Action	Windows/Linux	macOS
Nouvelle note	Ctrl+N	Cmd+N
Palette de commandes	Ctrl+P	Cmd+P
Coller sans formatage	Ctrl+Shift+V	Cmd+Shift+V
Supprimer la ligne actuelle sans sélection	Ctrl+Shift+K	Cmd+Shift+K
Mettre en gras le texte sélectionné	Ctrl+B	Cmd+B
Mettre en italique le texte sélectionné	Ctrl+I	Cmd+I

Obsidian sépare les raccourcis d’édition système des raccourcis de commande personnalisables. Ouvrez Paramètres → Raccourcis clavier pour vérifier ou modifier des commandes telles que l’insertion d’un modèle, l’ouverture d’une note quotidienne ou l’exécution d’une action de plugin. Sur una disposition de clavier non-US, la touche affichée peut ne pas correspondre à l’étiquette physique de la touche.

Tableau de décision pratique pour le formatage

Si vous devez…	Préférez	Pourquoi
Partager la note avec d’autres éditeurs Markdown	Liens, titres, listes et tableaux Markdown standard	Ce sont les structures les plus portables.
Connecter des notes dans un même coffre	Wikilinks et références de bloc	Obsidian peut résoudre les noms de notes et pointer vers des sections exactes.
Réutiliser une liste de contrôle ou une définition	Une intégration	Une seule source peut se mettre à jour dans plusieurs notes.
Expliquer une décision sans interrompre la lecture	Un callout	Le contenu reste visible mais visuellement secondaire.
Suivre le travail à travers les notes quotidiennes	Tâches avec un modèle cohérent	La syntaxe des tâches reste lisible même sans plugin.

Cette distinction évite un piège courant : créer une belle note qui ne fonctionne que dans une seule vue ou une seule application. Commencez par du Markdown portable, puis ajoutez des fonctionnalités Obsidian là où elles éliminent les frictions réelles.

Liste de contrôle pour le dépannage

Lorsque le formatage semble incorrect en mode Lecture, vérifiez la syntaxe dans cet ordre :

1. Confirmez que chaque bloc de code possède des backticks de fermeture.
2. Ajoutez une ligne vide avant un nouveau paragraphe, tableau, liste ou callout.
3. Vérifiez si un |, *, _, # ou backtick nécessite un antislash d’échappement.
4. Pour un tableau, vérifiez la ligne délimitatrice et retirez les blocs multilignes des cellules.
5. Pour les sauts de ligne, utilisez sciemment Maj+Entrée, deux espaces finaux ou le paramètre Sauts de ligne stricts.
6. Si une commande ne s’exécute pas, recherchez-la dans la palette de commandes et inspectez son raccourci attribué.

Pour un système réutilisable, le formatage n’est que la première couche. Un modèle de note quotidienne, un flux de capture rapide, une revue hebdomadaire et une vue des tâches rendent les notes plus faciles à exploiter. Obsibrain ajoute ces workflows de planification et de gestion des tâches au cœur d’Obsidian.

Références officielles

• Syntaxe de formatage de base
• Syntaxe de formatage avancée
• Obsidian Flavored Markdown
• Raccourcis d’édition
• Raccourcis clavier
• Callouts

Poursuivez avec les liens dans Obsidian, les callouts ou la gestion des tâches.