Constructions de bloc

Extensions de bloc au-delà du cœur Markdown. Chaque chapitre montre la syntaxe en bloc de code et le résultat rendu juste en dessous ; la vue scindée les met côte à côte.

Callouts

Encadrés : > [!type] comme première ligne d’une citation, avec un titre personnalisé en option. Dix types avec icône et couleur d’accent propres : note, info, tip, success, question, warning, failure, danger, example, quote. Les types inconnus sont signalés par le linter Markdown.

> [!tip] Titre personnalisé
> Contenu de l'encadré, Markdown normal autorisé.

Un + ou - après le type rend le callout pliable : + démarre ouvert, - replié — le pliage fonctionne aussi ici dans le manuel.

> [!note]- Démarré replié
> Visible seulement après un clic sur le titre.

Conteneurs personnalisés

Blocs conteneurs entre ::: type et :::. Les dix types de callout s’affichent en style callout, les noms inconnus en boîte neutre avec le nom comme titre.

::: warning
Contenu en style callout.
:::

Bloc multicolonne

Un conteneur ::: columns <n> affiche le contenu inclus sur plusieurs colonnes ; les valeurs valides vont de 2 à 5. Le texte se répartit automatiquement et de façon équilibrée sur les colonnes ; une ligne +++ force le passage à la colonne suivante. Les nombres de colonnes invalides (absent, 1, plus de 5, non numérique) retombent sur la boîte neutre ; hors d’un bloc multicolonne, +++ reste sans effet.

::: columns 2
Première colonne avec du texte.

+++

La deuxième colonne commence ici.
:::

Les contenus larges (tableaux, diagrammes, longues lignes de code) peuvent déborder d’une colonne ; sur les blocs très courts, l’équilibrage automatique peut paraître inégal. En mode Direct, le bloc apparaît comme conteneur neutre avec les lignes de marqueur visibles ; la mise en colonnes vaut pour la vue rendue et l’export PDF.

Listes de définitions

Terme sur une ligne, définition en dessous introduite par : ; ~ est aussi accepté comme marqueur. Plusieurs définitions par terme sont possibles.

Cutover
: Bascule d'un système en exploitation productive.

Rollback
: Retour à l'état antérieur à la bascule.

Cutover

Bascule d’un système en exploitation productive.

Rollback

Retour à l’état antérieur à la bascule.

Blocs de lignes

Les lignes commençant par | conservent les retours à la ligne et les espaces de tête — pour les adresses et les poèmes.

| Stumm-Consulting GmbH
|   4410 Liestal
|   Suisse

Notes de bas de page

Trois formes : référence [^id] dans le texte avec une définition [^id]: texte (habituellement en fin de fichier), plus la forme en ligne ^[texte direct] sans définition séparée. Le rendu affiche un chiffre en exposant ; les définitions se regroupent en bas de page avec des flèches de retour.

Une affirmation avec source[^1] et une avec note en ligne^[notée directement].

[^1]: La définition se trouve en fin de fichier.

Une affirmation avec source^[1] et une avec note en ligne^[2].