Le Markdown, c'est quoi ?

Le Markdown est une façon d'écrire du texte enrichi en utilisant uniquement des caractères du clavier. Pas de menus, pas de boutons : juste du texte, avec quelques symboles simples pour indiquer la mise en forme.

Un # devant une ligne, c'est un titre. Deux  ** autour d'un mot, c'est du gras. Un - en début de ligne, c'est une puce. C'est à peu près tout ce dont on a besoin pour 90 % des documents du quotidien.

# Compte-rendu de réunion – 18 février 2026

## Participants
- Alice
- Bob
- Carol

## Décisions prises

Le projet sera lancé en **mars**. Carol prend en charge la communication.

## Actions
- [ ] Alice : préparer le rétroplanning
- [ ] Bob : contacter les prestataires

Ce qui est remarquable dans cet exemple, c'est qu'il est déjà parfaitement lisible tel quel avant même d'être mis en forme. Les titres sont évidents, les listes se voient d'un coup d'œil, les cases à cocher sont compréhensibles. C'est une des grandes forces du Markdown : même brut, il est déjà propre et structuré.

Texte brut ou interprété : le meilleur des deux mondes

Un fichier Markdown peut être utilisé de deux façons.

En texte brut, c'est un simple fichier .md que vous ouvrez dans n'importe quel éditeur de texte. Pas besoin de logiciel spécifique. Il s'ouvre sur tous les systèmes, il se copie, il se partage par email, et il sera encore lisible dans dix ans sans se soucier de compatibilité. C'est une vraie différence avec un fichier Word : le .docx est un format binaire compressé, illisible sans le bon logiciel.

Interprété, ce même fichier devient un document visuellement soigné : les titres s'affichent en grand, le gras ressort, les cases à cocher deviennent interactives, les blocs de code sont colorés. La plupart des outils modernes dont Nextcloud savent faire cette transformation automatiquement.

C'est cette double nature qui rend le Markdown si solide : il est portable et pérenne sous forme brute, et agréable et lisible une fois rendu. Vos documents ne sont prisonniers ni d'un logiciel, ni d'une entreprise.

Nextcloud parle presque Markdown mais pas tout à fait

Nextcloud n'utilise pas le Markdown dans sa forme strictement officielle : il en parle un dialecte très proche, avec quelques extensions et particularités qu'il vaut mieux connaître.

La plus notable concerne le souligné : dans Nextcloud, __texte__ produit du texte souligné. Or dans le Markdown standard, cette syntaxe signifie gras exactement comme **texte**. Ce n'est pas un bug, c'est un choix d'extension, mais un fichier .md écrit dans Nextcloud avec du souligné pourra s'afficher différemment dans un autre éditeur.

Pour le reste, Nextcloud s'appuie sur le GitHub Flavored Markdown (GFM), une variante très répandue et bien supportée ailleurs : blocs de code avec langage (```bash), barré (~~texte~~), cases à cocher (- [ ]), tableaux… Tout cela fonctionnera dans la grande majorité des outils modernes.

Deux fonctionnalités sont en revanche propres à Nextcloud et n'ont aucun équivalent Markdown : @nom pour mentionner un collaborateur, et /quelque chose pour le sélecteur intelligent. Dans un autre éditeur, ces éléments s'afficheraient simplement comme du texte brut.

Les trois façons d'écrire dans Nextcloud

C'est là que Nextcloud a fait un choix intelligent : l'éditeur accepte trois approches, au choix, selon votre confort.

Les boutons visuels une barre d'outils classique avec ses icônes Gras, Italique, Titre, Liste, Case à cocher… Vous cliquez, c'est fait. Pas besoin de connaître quoi que ce soit au Markdown.

Les raccourcis clavier pour aller plus vite sans quitter le clavier. Ctrl + B pour le gras, Ctrl + Maj + 9 pour une case à cocher, Ctrl + Maj + 1 pour un titre de niveau Ctrl + K pour un lien…

La syntaxe Markdown directement pour ceux qui ont envie de l'apprendre : taper **mot** met en gras, # Titre crée un titre, et ainsi de suite.

Dans tous les cas, le fichier produit est identique : du Markdown standard, léger, hébergé sur votre serveur Nextcloud.

La complétion automatique : la vraie magie de l'éditeur

C'est le point qui surprend le plus les nouveaux utilisateurs et celui qu'il faut bien comprendre pour ne pas être perdu.

Quand vous tapez [] dans Nextcloud Text et appuyez sur Entrée, vous voyez apparaître instantanément une case à cocher visuelle et interactive. Et si vous allez ensuite regarder le fichier brut sur votre serveur, vous trouvez - [ ]  avec un tiret, des espaces, des crochets, tout ce que vous n'avez pas tapé.

Même chose avec les blocs de code HTML : vous tapez ```html et l'éditeur ouvre automatiquement une fenêtre de code stylisée. Dans le fichier brut, il a aussi ajouté le  ``` de fermeture tout seul.

Ce mécanisme s'appelle des input rules  des règles de complétion automatique intégrées à l'éditeur. C'est exactement comme un éditeur de code qui complète automatiquement les parenthèses ou les guillemets quand vous en ouvrez un. Ici, c'est la même logique appliquée à la syntaxe Markdown : vous tapez un raccourci simplifié, l'éditeur génère la syntaxe complète et correcte en coulisses.

L'intérêt est double : vous n'avez pas besoin de connaître la syntaxe exacte pour l'utiliser, et si vous ouvrez un jour le fichier brut, vous voyez exactement ce que l'éditeur a généré du Markdown propre et standard. Rien de mystérieux, rien de caché.

Comprendre le Markdown aide pour aller plus vite

Vous pouvez utiliser Nextcloud Text, Notes et Deck (Gantt) sans jamais avoir entendu parler du Markdown. Les boutons sont là, la complétion automatique fait le reste. Vous ne serez jamais bloqué.

Mais connaître quelques bases change quand même la vie au quotidien. Ça permet d'aller plus vite, de comprendre ce qu'on voit quand on ouvre un fichier brut, et d'être à l'aise dans n'importe quel outil qui utilise ce format.

Voici l'essentiel à retenir :

Dix minutes suffisent pour retenir ça. Et une fois acquis, ça s'applique partout : Nextcloud bien sûr, mais aussi des plateformes collaboratives, des outils de documentation, des CMS, des messageries professionnelles…

Des usages concrets du quotidien

Le compte-rendu de réunion collaboratif

Avec Nextcloud Text, plusieurs personnes peuvent écrire dans le même fichier en temps réel, comme sur un Google Doc  mais hébergé sur votre propre serveur. On ouvre un fichier .md, on structure la prise de notes au fil de la réunion, on note les décisions et les actions à mener. Le résultat est immédiatement partageable, sans mise en page chronophage.

La checklist de préparation

Pour organiser un événement, suivre une procédure, préparer un déménagement : une liste dans Deck ou Notes suffit. On tape [] + Entrée, la case apparaît, et chaque item peut être coché une fois accompli. Pas besoin d'un tableur ni d'un outil dédié.

Le brouillon de page web

Avant d'intégrer du contenu dans un site, le Markdown est idéal pour structurer les idées : titres, paragraphes, listes. Le fond avant la forme. L'équipe technique récupère un contenu déjà proprement organisé, ce qui simplifie le travail de tout le monde.

Le programme d'un événement

Horaires, intervenants, temps forts : un programme se rédige en quelques minutes. Il est lisible directement en texte brut, et se transforme en document soigné en un clic si besoin.

En résumé

Le Markdown est un format simple, lisible, universel et pérenne. Nextcloud l'a adopté comme format natif de ses outils de rédaction, en y ajoutant une couche intelligente : boutons visuels, raccourcis clavier, et complétion automatique. Vous pouvez l'utiliser sans jamais en connaître la syntaxe mais si vous en apprenez les bases, vous serez plus à l'aise, plus rapide, et jamais surpris par ce que vous voyez dans un fichier brut.

Cet article fait partie d'une série sur le Markdown et son utilisation dans Nextcloud :

- Les tableaux en Markdown : tout ce qu'il faut savoir

- Mettre en valeur l'information en Markdown : bandeaux et blocs dépliants

Ézéo est une coopérative bretonne spécialisée dans les solutions numériques libres. Nous accompagnons les organisations de l'ESS, les collectivités et les entreprises vers plus de souveraineté numérique.