Fichier .md dans Obsidian : format, ouverture et portabilité
Un fichier .md est un fichier texte Markdown. Dans Obsidian, chaque note ordinaire est enregistrée comme un fichier local que vous pouvez ouvrir, copier, sauvegarder et relire avec d’autres éditeurs. Cette page explique le fichier lui-même. Pour apprendre les titres, listes, tableaux, callouts et autres balises, consultez plutôt le guide de syntaxe Markdown dans Obsidian.
Que contient réellement un fichier .md Obsidian ?
Le corps d’une note contient du texte et des marqueurs Markdown lisibles : des dièses pour les titres, des tirets pour les listes, des crochets pour les liens. Les propriétés sont stockées au début du fichier dans un bloc YAML appelé frontmatter. Rien de tout cela n’exige une base de données propriétaire pour rester lisible.
---
type: note
tags:
- exemple
statut: à revoir
---
# Une note portable
Un paragraphe, puis un [[Lien interne]].Obsidian conserve aussi un dossier caché .obsidian à la racine du coffre. Il contient les réglages, thèmes et plugins du coffre, pas le texte principal de vos notes. Sauvegarder les fichiers .md protège donc le contenu ; sauvegarder aussi .obsidian permet de retrouver l’environnement de travail.
Où trouver et comment ouvrir les fichiers .md ?
- Dans Obsidian, faites un clic droit sur une note puis utilisez l’option permettant de l’afficher dans l’explorateur de fichiers.
- Dans Windows, macOS ou Linux, ouvrez le dossier du coffre : la note apparaît comme un fichier portant l’extension
.md. - Ouvrez ce fichier avec un éditeur de texte comme Visual Studio Code, Notepad++, Typora ou un éditeur compatible Markdown.
- Revenez dans Obsidian : il détecte normalement les changements externes et actualise le coffre.
N’ouvrez pas le dossier global de configuration d’Obsidian comme un coffre. Le coffre est votre dossier de travail ; le dossier système de l’application sert au runtime. Cette distinction évite de déplacer ou supprimer les mauvais fichiers.
Pourquoi le .md améliore la portabilité
Le principal avantage n’est pas que tous les outils rendent la note exactement comme Obsidian. C’est que le texte reste accessible sans Obsidian. Vous pouvez indexer les fichiers, les versionner avec Git, les synchroniser, les traiter avec des scripts ou les migrer vers un autre éditeur.
- Texte durable : le contenu reste lisible dans un simple éditeur.
- Sauvegarde simple : le coffre peut être copié comme un dossier ordinaire.
- Recherche universelle : les outils du système peuvent parcourir les fichiers.
- Automatisation : un script peut lire ou transformer le Markdown sans exporter une base fermée.
- Migration : l’importeur officiel d’Obsidian accepte plusieurs formats, dont Markdown.
Ce qui est standard, et ce qui dépend d’Obsidian
Obsidian combine CommonMark, GitHub Flavored Markdown et plusieurs extensions. Les titres, paragraphes, listes, emphases, liens Markdown et blocs de code voyagent généralement bien. En revanche, certaines fonctions sont propres à Obsidian ou demandent une adaptation ailleurs.
Les wikilinks comme [[Ma note]], les transclusions ![[Image.webp]], les callouts et les références de blocs sont très pratiques dans Obsidian, mais ne sont pas universellement interprétés. Si l’interopérabilité est prioritaire, Obsidian peut créer des liens Markdown standards plutôt que des wikilinks.
Liens, renommages et chemins : les points sensibles
Un lien interne peut viser le nom d’une note ou son chemin dans le coffre. Obsidian sait mettre à jour les liens quand un fichier est renommé si l’option correspondante est active. Hors de l’application, un renommage manuel ne bénéficie pas forcément de cette protection.
- Évitez les noms de fichiers contenant des caractères problématiques pour Windows, macOS ou Linux.
- Choisissez une convention de noms stable avant de multiplier les automatisations.
- Préférez les liens Markdown standards si les notes doivent être publiées ou ouvertes dans plusieurs outils.
- Contrôlez les pièces jointes : une note portable sans son image ou son PDF reste incomplète.
Les propriétés YAML restent-elles portables ?
Oui, le frontmatter YAML est du texte. Mais la façon de typer, afficher ou exploiter une propriété dépend de l’outil. Obsidian reconnaît notamment texte, listes, nombres, cases à cocher, dates, tags et liens. Un autre éditeur peut conserver ces lignes sans proposer la même interface.
Le bon garde-fou consiste à garder peu de propriétés, avec des noms stables et une utilité réelle. Un frontmatter de vingt champs vides est portable techniquement, mais coûteux cognitivement.
Comment sauvegarder un coffre Obsidian sans se tromper
- Conservez au moins une copie indépendante du dossier du coffre.
- Vérifiez la restauration : une sauvegarde non testée reste une hypothèse.
- Incluez les pièces jointes et, si vous voulez restaurer l’expérience complète, le dossier
.obsidian. - Ne confondez pas synchronisation et sauvegarde : une suppression synchronisée peut se propager.
- Versionnez les changements importants si votre usage justifie Git ou un historique équivalent.
Pour choisir une méthode adaptée à plusieurs appareils, poursuivez avec le guide Obsidian Sync et synchronisation du coffre.
Questions fréquentes sur les fichiers .md
Peut-on ouvrir un fichier Obsidian sans Obsidian ?
Oui. Une note ordinaire est un fichier texte .md. Vous pouvez l’ouvrir dans n’importe quel éditeur de texte. Le rendu des extensions propres à Obsidian peut toutefois être différent.
Renommer .md en .txt suffit-il ?
Le contenu reste du texte, mais changer l’extension peut empêcher Obsidian de reconnaître le fichier comme une note. Il vaut mieux laisser .md et choisir un éditeur compatible Markdown.
Les images sont-elles contenues dans le fichier .md ?
En général, non. Le fichier contient un lien ou une transclusion vers un fichier image séparé. Il faut donc sauvegarder et déplacer les pièces jointes avec les notes.
Quelle page lire pour apprendre la syntaxe ?
Le rôle de cette page est le format et la portabilité. Pour écrire correctement, utilisez le guide Markdown Obsidian ; pour démarrer de zéro, suivez le tutoriel Obsidian pour débutants.