DOKUMENTATION

Häufige Fragen

Antworten zu Plattformen, Updates, Markdown-Unterstützung, Wiederherstellung und Fehlerbehebung — plus die bekannten Grenzen der aktuellen Version.

Was ist Markion?

Markion ist ein nativer Desktop-Markdown-Editor, gebaut in Rust mit dem GPU-beschleunigten UI-Framework GPUI. Es bietet vier Ansichtsmodi — Bearbeiten, visuell, geteilt und Lesen — plus Gliederung, Dateibaum, Suchen/Ersetzen, Fokus- und Schreibmaschinenmodus sowie Export in mehrere Formate.

• Lizenz: MIT
• Repository: github.com/willmove/markion
• Probleme: GitHub Issues

Welche Plattformen werden unterstützt?

Releases sind nicht plattformseitig code-signiert; beim ersten Start können Gatekeeper (macOS) oder SmartScreen (Windows) warnen — manuell durchlassen. Der Windows-x86_64-In-App-Updater prüft seine NSIS-Last separat mit einem Minisign-Schlüssel, unterdrückt SmartScreen aber nicht. macOS- und Linux-Updates öffnen den Release-Download im Systembrowser. Linux-Nutzer mit .deb erhalten die nötigen Laufzeitbibliotheken (Wayland / X11 / Vulkan / fontconfig) automatisch.

Welche Markdown-Funktionen gibt es?

Markion nutzt pulldown-cmark (CommonMark + GFM) mit Folgendem aktiviert:

• CommonMark-Grundlage
• GitHub Flavored Markdown: Tabellen, Durchstreichung, Aufgabenlisten, Autolinks
• Fußnoten
• Formeln ($inline$ und $$block$$)
• ```mermaid Mermaid-Diagramme (-Zaunblöcke — Fluss-, Sequenzdiagramme u. a.)
• Intelligente Interpunktion (typografische Anführungszeichen, Gedankenstriche)
• Überschriftenattribute
• YAML-Frontmatter (--- begrenzt, title / author / date für den Export)
• Erweiterte Inline-Syntax (Markion-spezifisch, über pulldown-cmark-Textläufe): ==highlight==, ^superscript^, ~subscript~, Emoji-Shortcodes wie :smile: und :heart:, nackte Autolinks

Siehe Markdown & Darstellung für Details. Fußnoten sind immer aktiv — es gibt keinen Schalter.

Was unterscheiden die vier Ansichtsmodi?

Durchlaufen Sie die vier Modi mit Ctrl+Shift+V (Standard: visuelles Bearbeiten) oder springen Sie direkt mit Ctrl+//Ctrl+E/Ctrl+P/Ctrl+R: Bearbeiten (nur Quelle), visuell (WYSIWYG-zuerst, quellgestützt), geteilt (Quelle links, Vorschau rechts) und Lesen (nur gerenderte Vorschau, nicht editierbar). Beim Wechsel bleiben Dokument, Cursor/Auswahl, Undo und Scroll je Tab erhalten. Siehe Bearbeitungsmodi.

Wie werden Formeln gesetzt?

Die Bildschirmdarstellung (geteilte/Lesevorschau und visuelles Bearbeiten) setzt $inline$ und $$block$$ mit einer eingebetteten RaTeX-Engine (KaTeX-kompatibel, gebündelte Schriften) in gecachtes SVG — ohne Netz und ohne externes LaTeX. Der LaTeX-Export behält den nativen $...$/$$...$$-Quelltext für die Toolchain des Lesers; der eingebaute DOCX-Export senkt Formeln auf eine lesbare Unicode-Klartextnäherung ab.

Wie funktionieren Autosave und Wiederherstellung?

Markion schreibt standardmäßig nach fünf Sekunden Pause Wiederherstellungs-Snapshots und speichert benannte Dateien still. Unter Einstellungen → Allgemein können Sie Still speichern abschalten (Wiederherstellung bleibt) oder 1–300 Sekunden einstellen. enabled = false schaltet beides ab:

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

Für nie gespeicherte Dokumente schreibt Markion eine Wiederherstellungskopie ins Recovery-Verzeichnis. Nach unerwartetem Ende bietet der nächste Start an, die ungespeicherte Arbeit daraus wiederherzustellen. Die Titelleiste zeigt ein * neben dem Dateinamen bei ungespeicherten Änderungen.

Wie ist die Leistung bei großen Dokumenten?

Markion speichert abgeleiteten Zustand (Vorschaublöcke, Gliederung, Statistik, Hervorhebung) je Dokumentversion und teilt ihn über Arc, sodass Tippen in großen Dokumenten nicht bei jedem Tastendruck alles neu ableitet. Die syntect-Grammatik lädt beim Start außerhalb des Hauptthreads. Quellkartiertes visuelles Bearbeiten nutzt nach lokalen Änderungen unabhängig parsebare Bereiche inkrementell wieder und fällt auf volle Ableitung zurück, wenn Kontext oder Bytebereiche unsicher sind; die geteilte/Lesevorschau bleibt entprellt und gecacht, nicht inkrementell. Markion nutzt weiter einen String-Puffer statt eines Ropes; manche semantischen Lesungen parsen bewusst vollständig.

Fehlerbehebung

• macOS sagt, Markion „kann nicht geöffnet werden, weil es von einem unbekannten Entwickler stammt.“ Das ist Gatekeeper. Rechtsklick auf die App und Öffnen, oder in Systemeinstellungen → Datenschutz & Sicherheit auf Trotzdem öffnen. Releases sind unsigniert.
• Windows SmartScreen warnt vor dem Installer. Klicken Sie Weitere Informationen → Trotzdem ausführen. Releases sind unsigniert.
• Wie wähle ich ein PDF-Backend? Öffnen Sie Einstellungen → Export und wählen Sie die eingebaute Engine oder Pandoc. Die eingebaute Engine unterstützt CJK, Bilder, Tabellen, Code und Vektorformeln ohne externe Werkzeuge. Pandoc braucht seine Toolchain und fällt bei Fehlen oder Fehlschlag zurück. Die Statusleiste nennt das genutzte Backend.
• Ein eigenes Theme erscheint nicht in den Einstellungen. Prüfen Sie, dass die .toml-Datei im Themes-Verzeichnis liegt (siehe die Datenverzeichnis-Tabelle in Themes, Sprachen & Einstellungen), dass name gesetzt und nicht leer ist, und dass kein mitgeliefertes Theme denselben Namen hat (Mitgelieferte haben Vorrang).
• Wo sind die Protokolle? Siehe die Protokollspalte der Datenverzeichnis-Tabelle in Themes, Sprachen & Einstellungen. Setzen Sie RUST_LOG=debug vor dem Start für mehr Details.

Bekannte Einschränkungen

• Visuelles Bearbeiten ist WYSIWYG-zuerst und behält kanonisches Markdown; Konstrukte ohne bewiesene bytegenaue Darstellung behalten den exakten Quellweg als Übergang (WYSIWYG-Roadmap) statt geratener Rich-Tree-Mutation; Blockumordnung nur bei beweisbar nicht überlappenden Grenzen.
• Die Bildschirmdarstellung setzt Formeln mit eingebettetem RaTeX; der LaTeX-Export behält nativen $...$/$$...$$-Quelltext, der eingebaute DOCX-Fallback senkt Formeln weiter auf lesbaren Klartext ab statt gesetzte Glyphen einzubetten.
• Visuelle Tabellenzellen erlauben direktes Klartext-Editieren, aber noch keine reichen Inline-Formatierungen in Zellen. Referenz-/mehrzeilige Bilder, fehlerhafte Tabellen und HTML-Entitäten im Fließtext bleiben bekannte Lücken der WYSIWYG-Roadmap mit quellgestütztem Weg.
• Ein-Klick-Updates installieren die Windows-NSIS-Verteilung nach Minisign-Prüfung; macOS-Bundle-Ersatz und Linux-.deb/AppImage-Selbstersatz sind Zukunft, die Authentifizierung ist weder Windows Authenticode noch Apple-Notarisierung.
• Eine vollständige UI zur Theme-Installation fehlt weiterhin; Theme-Dateien gehören manuell ins Themes-Verzeichnis.
• Bildexport ist ein statischer Snapshot des Dokumentlayouts; sehr große Dokumente nutzen noch kein Rope und keine voll inkrementelle Analyse in jedem abgeleiteten Teilsystem.

Fehler melden

Bitte Issues auf GitHub Issues einreichen. Markion-Version (erste Zeile im Startprotokoll) und Plattform helfen.