Le Markdown est une façon d'écrire, jamais une façon d'enregistrer. Ce que vous tapez en Markdown devient aussitôt des blocs ; l'article est enregistré en HTML.
Les raccourcis de frappe
Au début d'un paragraphe, suivis d'une espace :
| Tapez | Vous obtenez |
|---|---|
# ou ## | Titre de niveau 2 |
### à ###### | Titre de niveau 3 à 6 |
-, * ou + | Liste à puces |
1. ou 1) | Liste numérotée |
> | Citation |
``` | Bloc de code |
Dans une phrase, dès que la marque de fin est tapée :
| Tapez | Vous obtenez |
|---|---|
**mots** | gras |
*mots* ou _mots_ | italique |
`mots` | code |
Le # seul donne un niveau 2 : le titre de l'article est déjà le niveau 1.
Coller du Markdown
Collez un texte Markdown (de Claude, de GitHub, d'un fichier) : Markus le reconnaît et le met en blocs. Titres, listes, liens, images, tableaux, code, citations, notes de bas de page, listes de tâches : tout le Markdown courant est compris.
Le HTML écrit dans le Markdown ressort en texte : un <script> collé ne devient jamais une balise. Seules quelques balises de texte sans danger passent (br, kbd, sup, sub, mark, abbr...).
Une ligne <!-- readmore --> devient le Lire la suite de Joomla.
Coller depuis Word ou une page web
Le texte est nettoyé : les styles de Word disparaissent, les listes sont reconstruites, les titres restent des titres. Les images ne passent pas par le presse-papiers : Markus le dit, et vous les insérez avec le bloc Image.
Ouvrir et enregistrer un fichier .md
- Ouvrir un fichier .md charge le fichier dans l'article. On peut aussi le glisser sur l'article.
- Enregistrer en .md télécharge l'article en Markdown, nommé d'après son titre.
La vue Markdown
Écrire en Markdown (Ctrl+Maj+M) affiche tout l'article en Markdown. Modifiez-le, puis revenez aux blocs par le même raccourci.
Le Markdown ne sait pas tout écrire : un style, une classe, un saut de page, un commentaire HTML. Avant de passer en Markdown, Markus liste ce qui serait perdu, et vous choisissez : Passer en Markdown quand même, ou rester en blocs.
Le code source HTML
Code source HTML (Ctrl+Maj+U) affiche le HTML de l'article, avec la coloration de CodeMirror. Le même raccourci ramène aux blocs.
À jour pour Markus 1.0.088.