DOCUMENTATION

Questions fréquentes

Réponses sur les plateformes, les mises à jour, le Markdown, la récupération et le dépannage — plus les limites connues de la version actuelle.

Qu’est-ce que Markion ?

Markion est un éditeur Markdown natif de bureau écrit en Rust avec le cadre d’UI accéléré GPU GPUI. Il offre quatre modes — édition, visuel, scindé et lecture — plus un plan, une arborescence, rechercher-remplacer, les modes focus et machine à écrire, et l’export vers plusieurs formats.

• Licence : MIT
• Dépôt : github.com/willmove/markion
• Tickets : GitHub Issues

Quelles plateformes sont prises en charge ?

Les versions ne sont pas signées par la plateforme ; au premier lancement, Gatekeeper (macOS) ou SmartScreen (Windows) peuvent avertir — passez outre à la main. Le mise-à-jour in-app Windows x86_64 vérifie à part sa charge NSIS avec une clé Minisign, ce qui ne masque pas SmartScreen. macOS et Linux ouvrent le téléchargement dans le navigateur système. Les utilisateurs Linux du .deb reçoivent automatiquement les bibliothèques runtime (Wayland / X11 / Vulkan / fontconfig).

Quelles fonctions Markdown sont prises en charge ?

Markion utilise pulldown-cmark (CommonMark + GFM) avec ceci d’activé :

• Socle CommonMark
• GitHub Flavored Markdown : tableaux, barré, listes de tâches, autolinks
• Notes de bas de page
• Formules ($inline$ et $$block$$)
• ```mermaid Diagrammes Mermaid (blocs — organigrammes, séquences, etc.)
• Ponctuation intelligente (guillemets typographiques, tirets)
• Attributs de titre
• Front matter YAML (délimité par ---, title / author / date pour l’export)
• Syntaxe en ligne étendue (propre à Markion, sur les plages pulldown-cmark) : ==highlight==, ^superscript^, ~subscript~, shortcodes emoji comme :smile: et :heart:, autolinks nus

Voir Markdown et rendu pour les détails. Les notes de bas de page sont toujours actives — pas d’interrupteur.

Quelle est la différence entre les quatre modes ?

Parcourez les quatre modes avec Ctrl+Shift+V (défaut : édition visuelle), ou sautez à l’un d’eux avec Ctrl+//Ctrl+E/Ctrl+P/Ctrl+R : édition (source seule), visuel (WYSIWYG d’abord, adossé à la source), scindé (source à gauche, aperçu à droite) et lecture (aperçu rendu seul, non éditable). Le changement conserve document, curseur/sélection, annulation et défilement par onglet. Voir Modes d’édition.

Comment les maths sont-elles composées ?

Le rendu à l’écran (aperçu scindé/lecture et édition visuelle) utilise un moteur RaTeX embarqué (compatible KaTeX, polices incluses) pour $inline$ et $$block$$ en SVG mis en cache — sans réseau ni LaTeX externe. L’export LaTeX garde la source native $...$/$$...$$ pour la chaîne du lecteur ; l’export DOCX intégré dégrade les formules en approximation Unicode texte.

Comment fonctionnent l’enregistrement auto et la récupération ?

Markion écrit des instantanés de récupération après cinq secondes d’inactivité par défaut et enregistre silencieusement les fichiers nommés. Préférences → Général permet de couper l’enregistrement silencieux (la récupération reste) ou de régler 1–300 s. enabled = false coupe les deux :

[auto_save]
enabled = true
silent_save = true
delay_secs = 5

Pour les documents jamais enregistrés, Markion écrit une copie de récupération. S’il quitte brutalement, le lancement suivant propose de restaurer le travail. La barre de titre affiche un * à côté du nom s’il y a des modifications non enregistrées.

Comment ça se comporte sur de gros documents ?

Markion met en cache l’état dérivé (blocs d’aperçu, plan, statistiques, coloration) par version de document et le partage via Arc, donc taper dans un gros document ne tout recalcule pas à chaque frappe. Le registre de grammaires syntect se charge hors du fil principal au démarrage. L’édition visuelle cartographiée réutilise de façon incrémentale les régions parseables après des édits locaux et retombe sur une dérivation complète si le contexte ou les plages d’octets sont incertains ; l’aperçu scindé/lecture reste debounce et mis en cache, non incrémental. Markion utilise encore un tampon String plutôt qu’un rope ; certaines lectures sémantiques exigent volontairement une analyse complète.

Dépannage

• macOS dit que Markion « ne peut pas être ouvert car il provient d’un développeur non identifié ». C’est Gatekeeper. Clic droit sur l’app puis Ouvrir, ou dans Réglages Système → Confidentialité et sécurité cliquez Ouvrir quand même. Les versions ne sont pas signées.
• Windows SmartScreen avertit avant l’installateur. Cliquez Plus d’infos → Exécuter quand même. Les versions ne sont pas signées.
• Comment choisir un moteur PDF ? Ouvrez Préférences → Export et choisissez le moteur intégré ou Pandoc. L’intégré gère CJK, images, tableaux, code et maths vectorielles sans outils externes. Pandoc a besoin de sa chaîne et retombe sur l’intégré si elle manque ou échoue. La barre d’état identifie le moteur utilisé.
• Un thème perso n’apparaît pas dans Préférences. Vérifiez que le .toml est dans le répertoire des thèmes (voir le tableau des répertoires dans Thèmes, langues et préférences), que name est renseigné et non vide, et qu’aucun thème intégré n’a le même nom (les intégrés ont priorité).
• Où sont les journaux ? Voir la colonne Journaux du tableau des répertoires dans Thèmes, langues et préférences. Définissez RUST_LOG=debug avant le lancement pour plus de détail.

Limites connues

• L’édition visuelle est WYSIWYG d’abord tout en gardant le Markdown canonique ; les constructions sans rendu byte-exact prouvé exposent la source exacte en transition (feuille de route WYSIWYG) plutôt qu’une mutation d’arbre riche devinée ; le réordonnancement de blocs seulement si les frontières ne se chevauchent pas.
• Le rendu à l’écran compose les maths avec RaTeX embarqué ; l’export LaTeX garde $...$/$$...$$ natif, et le repli DOCX intégré dégrade encore les formules en texte lisible plutôt que des glyphes composés.
• Les cellules visuelles admettent le texte brut direct, mais pas encore de formatage riche en ligne. Images de référence/multilignes, tableaux malformés et entités HTML dans le corps restent des trous connus de la feuille de route WYSIWYG avec chemin source.
• Les mises à jour en un clic installent la distribution NSIS Windows après Minisign ; le remplacement du paquet macOS et l’auto-remplacement .deb/AppImage Linux restent à venir, et l’authentification n’est ni Authenticode ni notarisation Apple.
• Une UI complète d’installation de thèmes n’est pas implémentée : les fichiers de thème se placent à la main dans le répertoire des thèmes.
• L’export d’image est un instantané statique de la mise en page ; les très gros documents n’utilisent pas encore de rope ni d’analyse incrémentale complète dans chaque sous-système dérivé.

Signaler un problème

Ouvrez un ticket sur GitHub Issues. Indiquer la version de Markion (première ligne du journal au démarrage) et la plateforme aide.