EM4me

Bases de Markdown

L’application rend du Markdown sur la base du standard CommonMark, étendu par les tableaux, les listes de tâches, le texte barré et les liens automatiques. Cette page présente le cœur ; les constructions spéciales ont leurs propres pages (Constructions de bloc, Constructions en ligne, Liens).

Titres

Six niveaux avec # à ###### ; chaque titre reçoit automatiquement une ancre pour les liens et la table des matières.

## Chapitre
### Sous-chapitre

Il existe aussi la forme Setext pour les niveaux 1 et 2 : une ligne de texte soulignée par === (H1) ou --- (H2).

Chapitre en forme Setext
------------------------

Numérotation automatique

Les titres peuvent être numérotés automatiquement avec des numéros hiérarchiques (1, puis 1.1, 1.2, et ainsi de suite). Les numéros apparaissent dans le volet de rendu, le mode direct, le plan et les exports ; le texte source reste inchangé.

Le contrôle se fait sur trois niveaux qui se substituent dans cet ordre : le titre individuel avant le document, le document avant le réglage global. Globalement, le réglage « Numéroter les titres » active la numérotation et fixe le niveau de départ (H1 ou H2). Par document, la clé de frontmatter numbered-headings remplace le réglage global :

---
numbered-headings: true
---

Par titre, un marqueur en fin de ligne agit : {-} exclut un titre, {+} l’inclut, chacun aussi à l’encontre du réglage global. Une barre oblique inverse en tête protège le marqueur comme texte littéral (\{-} apparaît comme {-}).

## Annexe {-}
## Important {+}

Les titres exclus ne sont pas comptés et ne réinitialisent pas les sous-compteurs ; leurs sous-titres continuent de compter sous le dernier titre numéroté. Si un niveau est sauté, par exemple de H1 directement à H3, le niveau intermédiaire manquant compte comme un.

Emphase

**gras**, *italique*, ~~barré~~, `code en ligne`

gras, italique, barré, code en ligne

Listes

Listes non ordonnées avec -, * ou +, ordonnées avec 1.. Un sous-élément appartient à l’élément du dessus lorsqu’il commence là où commence le contenu de celui-ci : deux caractères sous - , trois sous 1. , quatre sous 10. .

- Premier point
  - Sous-point
1. Première étape
   1. Sous-étape
  • Premier point
    • Sous-point
  1. Première étape
    1. Sous-étape

Modifier la structure

En mode édition, le plan se modifie au clavier. La profondeur découle toujours de l’élément du dessus, vous n’avez pas à compter les espaces.

  • Alt+Flèche haut et Alt+Flèche bas déplacent un élément avec tous ses sous-éléments. Le saut couvre la branche voisine entière et le niveau reste identique. Hors des listes, les raccourcis déplacent la seule ligne.
  • Tab et Maj+Tab indentent et désindentent l’élément avec ses sous-éléments. L’indentation ne fonctionne que là où un élément situé au-dessus peut accueillir l’élément courant.
  • Si plusieurs lignes sont sélectionnées, les deux touches agissent exactement sur la plage sélectionnée.
  • La commande « Sélectionner la branche » marque un élément avec tout ce qui en dépend.

Numérotation

Les listes numérotées se renumérotent d’elles-mêmes dans le texte source dès que vous y travaillez. Le numéro de départ est conservé : une liste commençant à 3. continue avec 4..

Une ligne vide commence une nouvelle liste. Si elle naît de votre modification, la liste suivante repart à 1 ; si elle était déjà là, la seconde liste garde son propre numéro de départ. Le texte source et l’affichage montrent les mêmes numéros.

1. Première liste
2. Deuxième ligne

1. Nouvelle liste
2. Deuxième ligne

  1. Première liste

  2. Deuxième ligne

  3. Nouvelle liste

  4. Deuxième ligne

Poursuivre et terminer

La touche Entrée poursuit une liste et ajoute une puce, un numéro consécutif ou une case à cocher vide. Sur un sous-élément vide, elle désindente d’un niveau ; au niveau supérieur, elle termine la liste.

Tableaux

Tableaux pipe avec ligne d’en-tête et ligne de séparation ; les deux-points dans la ligne de séparation contrôlent l’alignement. Pour des cellules-bloc multilignes, voir Perspective Table ; pour le confort de saisie, l’éditeur de tableaux (voir Outils). Pour remanier des tableaux existants (déplacer, insérer et supprimer des lignes et des colonnes, alignement, transposition), utilisez le sous-menu Tableau dans le Menu contextuel de l’éditeur.

| Gauche | Centré | Droite |
|:-------|:------:|-------:|
| a      | b      | 12     |
Gauche Centré Droite
a b 12

Citation et ligne de séparation

> Citation sur
> plusieurs lignes

---

Citation sur plusieurs lignes

Liens et liens automatiques

Liens Markdown avec [texte](cible) ; les URL entre chevrons deviennent des liens automatiques. Les URL nues dans le texte courant sont aussi reconnues, mais le linter Markdown y recommande la forme explicite.

[Exemple](https://example.org) et <https://example.org>

Exemple et https://example.org

La forme par référence sépare l’emplacement du lien de la définition de la cible :

Voir la [page d'exemple][ref].

[ref]: https://example.org

Voir la page d’exemple.

Sauts de ligne forcés

Deux espaces en fin de ligne ou une barre oblique inverse forcent un saut de ligne dans un paragraphe.

Première ligne\
Deuxième ligne

Première ligne
Deuxième ligne

Code

En ligne avec des accents graves, en bloc avec trois accents graves ; une balise de langue active la coloration syntaxique (voir Mathématiques et diagrammes). La forme CommonMark « code indenté » s’applique aussi : les lignes indentées de quatre espaces deviennent un bloc de code.

Typographie

Le typographe remplace des séquences de caractères par des caractères typographiques : -- devient un tiret (–), ... des points de suspension (…), les guillemets droits deviennent typographiques.

Une pensée -- et une autre ...

Une pensée – et une autre …