Mathématiques et diagrammes
KaTeX compose les formules, Mermaid rend les diagrammes, les blocs de code reçoivent la coloration syntaxique — en vue Lecture, en vue scindée et en mode Direct.
KaTeX en ligne
Les formules entre signes dollar simples se rendent dans le texte courant. Une heuristique protège les montants en dollars : $100 dans une phrase reste du texte, seules les vraies paires de formules sont composées.
La solution est $x = \frac{-b \pm \sqrt{b^2-4ac}}{2a}$ selon la formule quadratique.
La solution est selon la formule quadratique.
KaTeX en bloc
Les doubles signes dollar composent une formule isolée et centrée.
$$
\sum_{i=1}^{n} i = \frac{n(n+1)}{2}
$$
Mermaid
Les blocs de code avec la balise de langue mermaid se rendent en diagrammes SVG et suivent le thème. Les types courants :
Flowchart
```mermaid
flowchart LR
A[Début] --> B{Décision}
B -->|oui| C[Mettre en œuvre]
B -->|non| D[Abandonner]
```
Source
flowchart LR
A[Début] --> B{Décision}
B -->|oui| C[Mettre en œuvre]
B -->|non| D[Abandonner]
Sequence
Source
sequenceDiagram
participant U as Utilisateur
participant A as Application
U->>A: ouvrir le fichier
A-->>U: vue rendue
Gantt
Source
gantt
dateFormat YYYY-MM-DD
title Mini-plan
section Phase 1
Concept :a1, 2026-01-01, 10d
Mise en oeuvre :after a1, 15d
Class
Source
classDiagram
class Tab {
+path
+viewMode
+close()
}
class Pane
Pane "1" --> "*" Tab
Blocs de code avec coloration syntaxique
Une balise de langue après les accents graves ouvrants active la palette de couleurs (suit le thème) :
```javascript
function greet(name) {
return `Bonjour, ${name} !`;
}
```
function greet(name) {
return `Bonjour, ${name} !`;
}
Le bouton de copie en haut à droite du bloc copie le contenu dans le presse-papiers — ici aussi dans le manuel.
Export
- Export PDF : les diagrammes sont imprimés comme graphiques vectoriels rendus, redessinés en clair pour l’impression ; les formules et la coloration du code apparaissent comme dans l’aperçu.
- Markdown portable : l’export incorpore le diagramme dans le fichier sous forme d’image finie — le destinataire le voit sans posséder ce programme. Le dessin est toujours clair, quel que soit le schéma de couleurs dans lequel vous travaillez. Un diagramme au texte source erroné reste inchangé comme bloc de code, afin que vous ne perdiez pas la source ; il en va de même lorsque l’extension « Diagrammes Mermaid » est désactivée. Le diagramme figure dans le fichier comme une image à adresse incorporée ; cela suppose un lecteur Markdown qui affiche le HTML incorporé et de telles images — pour le HTML, la même condition que pour les tableaux Perspective exportés. Les formules KaTeX et les blocs de code avec balise de langue relèvent de la syntaxe Markdown ordinaire et ne sont pas concernés.