Mis à jour pour Markion v0.3.1 · 2026-09-04

DOCUMENTATION

Markdown et rendu

Markion analyse le Markdown avec pulldown-cmark , en visant CommonMark et GFM. Le Markdown reste le format canonique du document en toute circonstance.

Commandes de formatage

Elles couvrent gras, italique, code en ligne, liens, images, titres, listes, listes de tâches, citations, blocs de code clôturés et tableaux Markdown source. Les titres exposent H1–H5 par défaut, extensibles à H1–H6 dans Préférences.

Rechercher et remplacer

Prend en charge la casse, les expressions régulières, suivant/précédent, remplacer l’occurrence et tout remplacer.

Tableaux

  • Les commandes de tableau source formatent les tableaux et ajoutent, suppriment ou déplacent lignes et colonnes.
  • En édition visuelle, les tableaux offrent en plus l’édition directe des cellules adossée à la source, le parcours Tab , des largeurs de colonne selon le contenu, et les mêmes opérations de lignes/colonnes.
  • Les tableaux de l’aperçu ordinaire restent en lecture seule.

Flux d’images locales

Ingestion des images du presse-papiers et des fichiers image glissés :

  • Markion les copie ou les encode dans un répertoire d’assets relatif au document, avec des noms résistants aux collisions, et insère des liens Markdown relatifs portables.
  • Remplacer une image existante conserve le texte alt et les métadonnées de présentation.
  • Des contrôles pratiques de taille/alignement sont exposés, et une ressource manquante affiche un état d’absence explicite.

Front matter YAML

Le front matter YAML délimité par --- est analysé et masqué dans l’aperçu ; ses title, author et date alimentent les métadonnées d’export (balises HTML <meta> , propriétés du document DOCX et préambule LaTeX).

Prise en charge du rendu

L’aperçu rendu prend en charge :

  • Gras, italique, barré, code en ligne, liens, surlignage (==highlight==), exposant (^superscript^), indice (~subscript~), notes de bas de page, listes de tâches, shortcodes emoji courants (comme :smile: et :heart:) et liens automatiques.
  • Numéros de départ corrects des listes ordonnées, listes imbriquées, puces par profondeur, alinéa suspendu, images et HTML embarqué.
  • Ponctuation intelligente (guillemets typographiques, tirets) et attributs de titre.

Copier depuis l’aperçu

Le texte de l’aperçu est sélectionnable, avec un menu contextuel pour copier en texte brut, Markdown ou HTML — plus l’adresse du lien le cas échéant.

Formules

$...$ formules en ligne et $$...$$ en bloc sont composées hors ligne en SVG mis en cache avec polices incluses par un moteur RaTeX embarqué (compatible KaTeX) — sans réseau ni LaTeX externe. En pratique :

  • Les formules en ligne restent sur la même ligne que le texte, et l’Unicode fonctionne à l’intérieur (ex. $\text{速度 } v$).
  • Les maths coexistent avec du Markdown imbriqué (gras, liens, code en ligne), chacun gardant son style.
  • ```math blocs clôturés (environnements de matrice, etc.) sont pris en charge.
  • Les formules volontairement larges défilent horizontalement au lieu d’être coupées.
  • Une source de formule invalide reste visible et éditable, au lieu de disparaître en silence.
  • En édition visuelle, seule la formule focalisée révèle sa source complète $...$, $$...$$ ou clôturée.

L’export LaTeX conserve la source native $...$/$$...$$ pour la chaîne de l’outil du lecteur ; l’export DOCX intégré dégrade les formules en une approximation texte lisible, sans glyphes composés.

Diagrammes Mermaid

```mermaid diagrammes clôturés (organigrammes, séquences, etc.) sont rendus en SVG assaini et mis en cache.

Coloration du code

Le code clôturé est coloré avec syntect et le jeu de grammaires étendu two-face, avec un analyseur de repli pour les langages non couverts et des numéros de ligne optionnels (commutables dans Préférences ou config.toml ).