Qu'est-ce que le format de fichier MD ?
Un fichier avec l'extension .md contient un document en texte brut créé à l'aide du langage Markdown. De nombreux dialectes de Markdown existent, mais tous utilisent le même ensemble de conventions et une syntaxe similaire. Les balises Markdown définissent des éléments de formatage de texte tels que :
- Attributs gras et italique
- En-têtes (titres)
- Format de tableau
- Listes
- Citations en bloc
- Intégration d'images et de code HTML
Les fichiers .md peuvent également utiliser le suffixe .MARKDOWN. Les fichiers .md peuvent être facilement convertis au format RTF ou PDF, bien qu'initialement Markdown ait été principalement utilisé pour générer des documents HTML, généralement des fichiers d'aide. Puisque le .md est un fichier texte brut, il peut être ouvert et édité avec n'importe quel éditeur de texte pour créer des documents formatés. Markdown utilise une syntaxe simple et facile à lire.
Markdown a été développé en 2004 par John Gruber, avec des contributions d'Aaron Swartz. L'objectif principal des concepteurs de ce langage était d'offrir aux utilisateurs un système de balisage simple et intuitif - contrairement au HTML, par exemple - pour l'édition et la création de documents. L'interprète original de fichiers .md, qui convertissait les fichiers .md en documents HTML, était écrit en Perl. De nombreuses variantes du langage Markdown ont été développées depuis lors. En 2016, la RFC 7763 a enregistré le type MIME text/markdown, et la RFC 7764 a répertorié les principales variantes de Markdown, notamment CommonMark, GFM, Markdown Extra, et d'autres.
Sécurité et sûreté
RISQUE : LOWUn fichier .md est du texte brut et ne peut pas exécuter de code, son ouverture est donc sûre. Seule mise en garde : Markdown autorise le HTML brut, donc un aperçu rendu pourrait contenir du HTML/JavaScript ou des images qui signalent votre présence - les moteurs de rendu réputés (GitHub, VS Code) nettoient cela. Comme toujours, méfiez-vous des liens à l'intérieur d'un document provenant d'une source inconnue avant de cliquer.
Détails du format
en brefProgrammes qui ouvrent les fichiers MD
Détails techniques
spécifications approfondies| Type MIME | text/markdown (enregistré par la RFC 7763, 2016) |
| Encodage des caractères | Texte brut UTF-8 ; pas d'en-tête binaire ni d'octets magiques - identifié par l'extension .md et la syntaxe conventionnelle |
| Style de syntaxe | Balisage léger - la source est lisible par l'homme sans analyseur ni moteur de rendu |
| Cible de sortie principale | HTML, produit par un processeur Markdown ; les cibles secondaires incluent le PDF et l'EPUB via des outils tels que Pandoc |
| Dialectes courants | CommonMark, GitHub Flavored Markdown (GFM), Markdown Extra, MultiMarkdown, R Markdown (.Rmd) |
| Prise en charge du Front matter | Le front matter YAML entre des délimiteurs --- est largement utilisé par les générateurs de sites statiques (Jekyll, Hugo, Eleventy) pour stocker les métadonnées de page |
| Syntaxe des titres | Le style ATX (# H1, ## H2) et le style Setext (souligné avec = ou -) sont tous deux valides dans la spécification de base |
| Syntaxe des liens | Liens en ligne [texte](url), style référence [texte][id], et lien automatique <url> - les trois formes font partie de la spécification centrale |
| Syntaxe des blocs de code | Délimité (triples accents graves ou tildes) ou indenté de 4 espaces ; un identifiant de langage après le délimiteur d'ouverture active la coloration syntaxique |
| Support des tableaux | Absent de la spécification originale de 2004 ; introduit comme une extension GFM et plus tard comme une extension optionnelle CommonMark |
| Syntaxe des images |  - stocke uniquement une référence URL ; les images ne sont pas intégrées dans le fichier .md lui-même |
| Barré | ~~texte~~ - une extension GFM ; absent de la spécification Markdown de base |
| Support Math / LaTeX | Syntaxe $en_ligne$ et $$bloc$$ reconnue par Obsidian, Jupyter, et les extensions VS Code mais en dehors de la spécification centrale |
| Règles de saut de ligne | Une ligne vide sépare les éléments de bloc ; les sauts de ligne forcés nécessitent deux espaces finaux ou un \ avant un saut de ligne (CommonMark) |
| Conflits d'extension | .md est occasionnellement revendiqué par des outils de métadonnées ou de description de machine ; le contenu du fichier et le contexte permettent de distinguer l'usage Markdown |
| Publié | 2004 (Markdown by John Gruber); CommonMark spec 2014; GitHub Flavored Markdown 2017 |
| Standard ouvert | Oui · libre de droits |
| Spécification | spec.commonmark.org |