Hilfe
Was ist Markzen?
Markzen ist ein Desktop-Editor für leichte Auszeichnungssprachen – Markdown und sechs weitere – mit einer Live-Vorschau im vollständigen Stil. Sie schreiben links einfachen Text, der mit einfacher Interpunktion ausgezeichnet ist, und Markzen rendert ihn während der Eingabe rechts als formatiertes HTML.
Was es von einem gewöhnlichen Markdown-Editor unterscheidet, ist der Round-Trip. Markzen liest acht Auszeichnungssprachen, rendert 30 Live-Erweiterungen (Diagramme, Charts, mathematische Formeln, Noten, Schachbretter, QR-Codes) innerhalb des Dokuments und exportiert in mehr als zwanzig Formate – E-Books, Word, PowerPoint, LaTeX, Jupyter-Notebooks und mehr. Einmal schreiben, das Ergebnis als fast alles übergeben. Der Konverter ist integriert, sodass keine externen Tools installiert werden müssen.
Sie können eine vorhandene Datei öffnen oder einfach mit der Eingabe beginnen – es ist nicht erforderlich, zuerst eine Datei zu öffnen.
Der Editor
Der linke Bereich ist ein vollständiger CodeMirror Code-Editor, keine einfache Textbox: Er verfügt über Syntaxhervorhebung für das Markup, das Sie schreiben, eine Formatierungs-Symbolleiste (fett, kursiv, Überschriften, Listen und mehr, plus spezielle Schaltflächen zum Einfügen von Links und Bildern – siehe Links & Bilder – und zum Einfügen einer Tabelle, siehe Tabellen & Tabellenkalkulationen), und eine Suchen-und-Ersetzen-Funktion. Standard-Bearbeitungs-Shortcuts – Kopieren, Einfügen, Rückgängigmachen, Wiederherstellen – funktionieren wie erwartet.
Sie schreiben in einer von acht leichtgewichtigen Markup-Sprachen. Dies sind Klartextformate, die Struktur mit Interpunktion (# für eine Überschrift, * für Betonung) anstelle von verstecktem Styling ausdrücken, sodass ein Dokument als Text lesbar und in der Versionskontrolle diff-freundlich bleibt. Markzen liest alle acht und entscheidet anhand der Dateierweiterung, um welche Sprache es sich handelt – Sie wählen das Format nie manuell aus. Kompatibilität listet auf, welche Erweiterungen welche Sprache öffnen.
Jede Sprache hat ihre eigenen Konventionen und ihr eigenes bestehendes Ökosystem von Dokumenten; Markzen rendert jede in ihrem eigenen Dialekt, anstatt alles zuerst in Markdown zu konvertieren. BBCode ist die einzige Sprache ohne einen einzigen Standard – jedes Forum erfand seine eigene Variante – daher liest Markzen sie großzügig, akzeptiert die gängigen Schreibweisen nebeneinander ([list] oder [ul], [h1] oder [heading=1]) und lässt alle Tags, die es nicht erkennt, als Klartext sichtbar, anstatt sie zu verschlucken. Um die Art des Markups zu ändern, in dem ein Dokument geschrieben ist, verwenden Sie das Menü Konvertieren in der Symbolleiste (siehe Konvertieren & Exportieren unten).
Nicht jede Sprache kann alles ausdrücken. Die Formatierungs-Symbolleiste enthält in jedem Dokument dieselben Schaltflächen, aber Markzen schreibt immer nur Markup, das die Sprache selbst definiert – es erfindet niemals einen privaten Dialekt, um eine Lücke zu überbrücken. Eine Schaltfläche, für die die aktuelle Sprache keine Notation hat, ist ausgegraut. Fett, kursiv, Überschriften, Listen, Codeblöcke, Links, Bilder, Regeln und Tabellen sind in allen acht verfügbar; die wenigen Lücken sind in Kompatibilität aufgeführt. Markdown ist die Sprache, die Menschen überrascht: Sie hat keine Standardmethode, um einen Absatz zu zentrieren, daher bietet Markzen dort keine Ausrichtungsschaltflächen an, anstatt etwas zu schreiben, das nur einige Leser honorieren würden.
Die Textgröße wird mit den Schaltflächen Text vergrößern und Text verkleinern der Symbolleiste eingestellt. Der Editorbereich kann auch vollständig ausgeblendet werden – wenn dies der Fall ist, wird Markzen zu einem reinen Lesegerät (siehe Live-Vorschau).
Links & Bilder
Die Formatierungs-Symbolleiste verfügt über zwei spezielle Schaltflächen, um einen Link oder ein Bild in das Dokument einzufügen, und jede öffnet ein kleines Popup direkt an der Cursorposition. Link (Strg+K) – oder drücken Sie Strg+K – fügt einen Hyperlink ein: Geben Sie den Linktext und seine Adresse ein, und Markzen schreibt das korrekte Markup dafür. Bild fügt ein Bild auf die gleiche Weise ein, mit einigen zusätzlichen Optionen, die unten behandelt werden.
Beide werden im Markup des aktuellen Dokuments geschrieben – ein in eine AsciiDoc-Datei eingefügter Link erscheint als AsciiDoc, in eine Org-Datei als Org und so weiter in allen acht Sprachen.
Ausgehend von einer bereits vorhandenen Adresse. Fügen Sie eine Webadresse in das Dokument ein, wählen Sie sie aus und drücken Sie Strg+K: Markzen erkennt, dass die Auswahl eine Adresse und keine Wörter ist, platziert sie im Adressfeld des Popups und lässt den Cursor im leeren Textfeld, um auf den gewünschten Linktext zu warten. Ohne dies wäre eine ausgewählte Adresse zum sichtbaren Text des Links geworden – ein Link, der als bloße URL gelesen wird. Absolute Dateipfade zählen auch als Adressen, unter Windows und anderswo, sodass dieselbe Tastenkombination einen eingefügten Pfad in einen Link zu dieser Datei umwandelt.
Einen bereits vorhandenen Link oder ein Bild bearbeiten. Platzieren Sie den Cursor an einer beliebigen Stelle eines vorhandenen Links oder Bildes und öffnen Sie das Popup erneut (die Schaltfläche oder Strg+K): Markzen erkennt das Konstrukt, lädt seinen aktuellen Text und seine Adresse in das Popup und ersetzt das Ganze, wenn Sie bestätigen – so bearbeiten Sie es direkt, anstatt versehentlich einen neuen Link in den alten zu verschachteln.
Für ein Bild bietet das Popup auch eine Schaltfläche Bild durchsuchen, um eine Datei von der Festplatte auszuwählen, anstatt einen Pfad einzugeben – es öffnet sich in dem Ordner, aus dem Sie zuletzt ein Bild entnommen haben, getrennt von dem Ordner, aus dem Ihre Dokumente stammen – und eine wichtige Wahl: ob das Bild eingebettet oder verknüpft ist.
Eingebettete oder verknüpfte Bilder
Wenn Sie ein Bild einfügen, kann Markzen es auf zwei Arten im Dokument speichern:
- Verknüpft – das Dokument verweist nur auf das Bild, per Dateipfad oder Webadresse. Die Dokumentdatei bleibt klein, aber das Bild muss mitreisen (oder unter seiner URL erreichbar bleiben), sonst wird es an anderer Stelle nicht angezeigt. Dies ist die Standardeinstellung.
- Eingebettet – die tatsächlichen Bytes des Bildes werden in das Dokument als Text geschrieben (ein base64
data:-Block), sodass die Datei vollständig eigenständig ist: Eine Datei enthält alles, ohne dass etwas verloren gehen kann. Der Kompromiss ist die Größe – das Dokument wächst um das Gewicht des Bildes, und ein eingebettetes Bild kann keinen relativen Pfad verwenden.
Wählen Sie „Eingebettet“, wenn Sie eine einzelne portable Datei übergeben möchten; wählen Sie „Verknüpft“, wenn Sie Bilder neben dem Dokument aufbewahren und die Datei klein halten möchten.
Für ein verknüpftes Bild erscheint eine weitere Option: Relativer Pfad. Wenn sich das Bild im eigenen Ordner des Dokuments (oder einem Unterordner) befindet, schreibt das Ankreuzen dieser Option den Verweis als kurzen relativen Pfad anstelle eines vollständigen absoluten Pfads, sodass der Link weiterhin funktioniert, wenn Sie das Dokument und seine Bilder zusammen verschieben. Es wird nur angeboten, wenn sich das Bild im Ordner des Dokuments befindet – andernfalls gibt es keinen relativen Pfad zum Schreiben.
Eingebettete Bilder bleiben im Editor übersichtlich. Ein base64-eingebettetes Bild ist eine lange Textwand, die sonst die umgebenden Zeilen verdecken würde, daher faltet Markzen jedes in einen kleinen Chip, der seinen Typ und seine Größe anzeigt (zum Beispiel 🖼 webp · 38 KB). Der Chip ist nur zur Anzeige – der zugrunde liegende Text bleibt unberührt, sodass Speichern, Kopieren oder Ausschneiden immer das vollständige Bild mit sich führt, und der Cursor überspringt den Chip als eine einzige Einheit.
Dateien, Tabs & Speichern
Markzen hält so viele Dokumente gleichzeitig geöffnet, wie Sie möchten, jedes in einem eigenen Tab, sodass Sie über mehrere Dateien hinweg arbeiten und frei zwischen ihnen wechseln können. Sie müssen keine Datei öffnen, um zu beginnen – tippen Sie in das leere Dokument, das bereits vorhanden ist, oder verwenden Sie die Dateischaltflächen der Symbolleiste:
- Neues Dokument – öffnet ein kurzes Menü (Neu erstellen), das die acht Auszeichnungssprachen auflistet; wählen Sie eine aus, um ein neues, leeres Dokument in dieser Auszeichnung in einem neuen Tab zu starten.
- Markdown-Datei öffnen – durchsuchen Sie eine vorhandene Datei und öffnen Sie sie. Der Dateiauswahldialog akzeptiert alle acht Auszeichnungsformate, und Markzen wählt das richtige anhand der Dateierweiterung aus. Es wird in dem Ordner geöffnet, aus dem Sie zuletzt ein Dokument entnommen haben, was zwischen den Sitzungen gespeichert wird, sodass Sie nicht jedes Mal von vorne beginnen müssen.
- Speichern – schreibt das aktive Dokument zurück in seine Datei. Ein Dokument, das noch nie gespeichert wurde, fällt auf „Speichern unter“ zurück, damit Sie es zuerst benennen können.
- Speichern unter – speichert das aktive Dokument in einer neuen Datei, wobei das Original unberührt bleibt.
Sie können auch eine Datei aus Ihrem Dateimanager ziehen und auf das Fenster ziehen, um sie zu öffnen.
Jedes geöffnete Dokument ist ein Tab oben im Fenster. Ein ungespeicherter Tab ist mit einem Punkt gekennzeichnet, und ein Tab, dessen Markup nicht Markdown ist, trägt ein kleines Formatabzeichen (zum Beispiel adoc). Das × auf einem Tab schließt ihn – und das Schließen eines Dokuments mit ungespeicherten Änderungen verwirft diese niemals stillschweigend: Eine Inline-Leiste erscheint auf dem Tab, sodass Sie zuerst Speichern oder Verwerfen können.
Während ein Dokument geöffnet ist, überwacht Markzen seine Datei auf der Festplatte. Wenn sich die Datei in einem anderen Programm ändert und Sie keine eigenen ungespeicherten Bearbeitungen haben, übernimmt Markzen die neue Version automatisch; wenn Sie doch ungespeicherte Bearbeitungen haben, fragt es zuerst – eine Inline-Leiste Neu laden lässt Sie entscheiden, ob Sie die Version auf der Festplatte übernehmen oder Ihre eigene behalten möchten.
Live-Vorschau
Der rechte Bereich zeigt das Dokument als gestyltes HTML, das sich live während der Eingabe aktualisiert. Links funktionieren, Tabellen sind ausgerichtet, Code wird in einem Monospace-Block angezeigt, Aufgabenlisten erhalten Kontrollkästchen, und jeder Rendering-Erweiterungsblock (siehe unten) zeichnet seine Figur an Ort und Stelle. Die Vorschau ist ein getreues Abbild dessen, wie ein HTML- oder PDF-Export aussehen wird.
Wenn ein Markdown-Dokument mit einem YAML-Front-Matter-Block beginnt – dem --- key: value --- Abschnitt, den Tools wie Jekyll, Hugo und Obsidian ganz oben platzieren – rendert Markzen ihn als übersichtliche Metadatenkarte über dem Dokument, anstatt die schließenden --- zu einer verirrten Überschrift werden zu lassen.
Layout-Modi
Eine Gruppe von drei Symbolleisten-Schaltflächen legt fest, was das Fenster anzeigt:
- Geteilte Ansicht – Editor und Vorschau nebeneinander. Ziehen Sie den Teiler, um den Platzanteil jedes Bereichs zu ändern.
- Editor einblenden – nur der Editor, der das Fenster für ablenkungsfreies Schreiben ausfüllt.
- Vorschau anzeigen – nur die Vorschau, ein sauberer, vollbreiter Leser.
Inhaltsverzeichnis
Die Schaltfläche Inhaltsverzeichnis öffnet ein Panel, das automatisch aus jeder Überschrift im Dokument (#, ##, ###, …) erstellt wird. Klicken Sie auf einen beliebigen Eintrag, um die Vorschau zu diesem Abschnitt zu scrollen. Jede Überschrift mit Unterüberschriften darunter zeigt ein Chevron: Klicken Sie darauf, um diesen Abschnitt zu Einklappen und seine verschachtelten Überschriften auszublenden, oder Ausklappen, um sie wieder anzuzeigen – so können Sie eine lange Gliederung auf die Teile reduzieren, an denen Sie gerade arbeiten. Die kleinen Schaltflächen 2 / 3 / 4 im Panel-Header begrenzen die Gliederung auf diese Überschriftentiefe – nützlich in einem langen Dokument, wenn Sie nur die obersten Ebenen sehen möchten – und ein erneuter Klick auf die aktive Schaltfläche bringt alle Ebenen zurück. Das Panel lässt sich durch Ziehen des linken Rands in der Größe ändern und zusammenklappen, um Lesefläche freizugeben. Es ist eine Navigationshilfe nur innerhalb der App – es erscheint niemals in einem Export.
Bereitstellung einer eigenen Gliederung. Wenn die Überschriften nicht die gewünschte Gliederung sind, kann ein Dokument seine eigene mitführen. Ein Codeblock mit dem Tag markzen, dessen erste Zeile toc ist, ersetzt das generierte Panel durch die darunter geschriebene Liste:
`markdown
```markzen
toc
- [Introduction](#intro)
- [Background](#background)
- [Results](#results)
```
Die Einrückung legt die Ebene fest, und jeder Eintrag verweist auf einen Anker, der im Dokument selbst existieren muss – eine Überschrift, der Sie eine explizite id gegeben haben, oder ein einfaches <a id="intro"></a>. Der Block selbst zeichnet nichts: Es sind Metadaten, die das Panel liest.
Tabellen & Tabellenkalkulationen
Tabellen lassen sich sauber zwischen Markzen und jeder Tabellenkalkulation verschieben. Fügen Sie tabulatorgetrennten Text – kopiert aus Excel, Google Sheets, Word oder einer Webtabelle – in den Editor ein, und Markzen wandelt ihn in eine richtige Tabelle um, die im eigenen Markup des Dokuments geschrieben ist, anstatt eine Wand von Tabulatorzeichen einzufügen. Der Einfüge-Leser ist anführungszeichenbewusst (er behandelt Zellen korrekt, die selbst Tabulatoren, Zeilenumbrüche oder Anführungszeichen enthalten) und wird nur ausgelöst, wenn die Zwischenablage ein sauberes rechteckiges Gitter von mindestens zwei Spalten enthält; alles andere wird als gewöhnlicher Text eingefügt.
Sie können auch eine Tabelle von Grund auf neu erstellen. Die Schaltfläche Tabelle einfügen in der Symbolleiste öffnet ein kleines Raster – fahren Sie darüber, um die gewünschte Anzahl von Zeilen und Spalten auszuwählen, und Markzen schreibt eine leere Tabelle dieser Größe in das eigene Markup des Dokuments, bereit zur Eingabe. Die erste Zeile ist die Kopfzeile.
Das Gegenteil funktioniert auch. Fahren Sie mit der Maus über eine gerenderte Tabelle in der Vorschau, und in deren Ecke erscheint eine Kopierschaltfläche: Sie kopiert die Tabelle als tabulatorgetrennten Text zurück, der direkt in eine Tabellenkalkulationszelle oder ein Word-Dokument eingefügt werden kann. Diese Kopierschaltflächen sind nur eine Vorschau-Annehmlichkeit – sie werden bei jedem Export und jeder Konvertierung entfernt, sodass eine freigegebene Datei nur die saubere Tabelle enthält.
Rendering-Erweiterungen
Markzen erweitert die Standardauszeichnung durch Codeblöcke. Der Sprach-Tag direkt nach den öffnenden drei Backticks entscheidet, wie der Block gerendert wird: Ein Tag, den Markzen als Erweiterung erkennt, zeichnet eine Live-Figur, anstatt den Code anzuzeigen.
Jede Art von Figur wird von einer eigenen Rendering-Engine gezeichnet, und Markzen ruft eine Engine ab, sobald ein Dokument sie tatsächlich anfordert, anstatt alle beim Start zu laden – deshalb startet die App fast sofort, und deshalb kann das erste Diagramm einer bestimmten Art einen Moment dauern, bis es erscheint, während jedes spätere sofort angezeigt wird.
Zum Beispiel rendert diese Quelle:
```mermaid
graph LR
A --> B --> C
```
als lebendiges Flussdiagramm, nicht als Code-Listing – und es bleibt auch in PDF- und HTML-Exporten ein Flussdiagramm.
Diagramme, Charts, Mathematik, Noten, Schach- und Go-Bretter, QR-Codes und mehr sind integriert – Kompatibilität listet jedes davon mit seinem Tag auf.
Jede Erweiterung hat ihren eigenen Sprach-Tag (mermaid, chartjs, katex, abc, chess, …). Sie können beliebig viele davon mit gewöhnlicher Prosa in einem einzigen Dokument mischen – sie werden alle zusammen gerendert. Ob eine Figur noch eine Figur ist, sobald das Dokument Markzen verlässt, hängt davon ab, wohin Sie es senden – siehe Konvertieren & Exportieren unten.
Formeln innerhalb eines Satzes
Eine mathematische Formel kann ein eigener Block sein – ein katex- oder asciimath-Block, der allein steht und wie eine Gleichung in einem Lehrbuch zentriert ist. Das funktioniert in allen acht Auszeichnungssprachen.
Eine Formel kann auch innerhalb eines Satzes stehen, so dass „die Fläche ist pi r Quadrat“ als eine Zeile Prosa mit echten Symbolen darin gelesen wird. Das hängt davon ab, ob die Auszeichnungssprache eine Notation dafür hat, und jede schreibt es anders – die Notation pro Sprache finden Sie unter Kompatibilität.
Textile und BBCode sind die beiden Ausnahmen, und das ist eine Grenze dieser Sprachen und nicht von Markzen: Keine von beiden hat jemals eine Möglichkeit definiert, Mathematik zu schreiben. In einem Textile- oder BBCode-Dokument muss eine Formel daher ein eigener Block sein. Nichts geht verloren – die Formel wird gerendert und überlebt den Export – sie kann einfach nicht in eine Zeile Prosa eingewoben werden.
Platzieren und Dimensionieren einer Figur
Fahren Sie mit der Maus über eine gerenderte Figur in der Vorschau, und ein kleines Panel erscheint daneben: Ausrichtung-Schaltflächen (links, Mitte, rechts) und – für die Arten von Figuren, die in der Größe geändert werden können – Breite- und Höhe-Felder in Pixeln. remove style block löscht sie wieder.
Diese Wahl wird nicht unsichtbar gespeichert: Das Panel schreibt sie in das Dokument, als kurzen Block mit dem Tag markzen, der unmittelbar vor der Figur platziert wird, auf die er sich bezieht.
```markzen
style
align center
width 480
```
So reist das Layout mit der Datei – es ist Teil dessen, was Sie speichern, übergeben und exportieren, auf jeder Maschine. Sie können den Block auch von Hand schreiben: eine Direktive pro Zeile, align (left, center oder right), width und height in Pixeln, immer auf den direkt darunter liegenden Block angewendet.
Ein Dokument mit CSS gestalten
Ein Markdown-Dokument kann auch ein eigenes Stylesheet in einem Codeblock mit dem Tag style enthalten:
```style
h2 { color: #b03030; border-bottom: 2px solid #b03030; }
blockquote { font-style: italic; }
```
Die Regeln gelten für die Vorschau dieses Dokuments und für seine PDF- und HTML-Exporte, zusätzlich zu der jeweils aktiven Stilvorlage – eine Möglichkeit, einem Dokument ein eigenes Aussehen zu verleihen, ohne Ihre Einstellungen für alles andere zu ändern. Nur gewöhnliche Selektoren: At-Regeln wie @media und @keyframes werden nicht unterstützt, und der Block funktioniert nur in Markdown-Dokumenten.
Konvertieren & Exportieren
Das Menü Konvertieren in der Symbolleiste ist der Ort, an dem ein fertiges Dokument Markzen verlässt. Es erfüllt zwei unterschiedliche Funktionen.
In eine andere Auszeichnungssprache konvertieren. Unter Leichtes Markup wird das offene Dokument in eine der sieben anderen Auszeichnungssprachen umgeschrieben – AsciiDoc, BBCode, Djot, MediaWiki, Org, reStructuredText oder Textile. Nützlich, wenn ein Wiki MediaWiki, ein Forum BBCode, ein Verlag AsciiDoc benötigt oder Sie Notizen zwischen Ökosystemen verschieben. Jede der acht erscheint einmal im Menü als Auszeichnungssprache: Ein von hier aus als MediaWiki gespeichertes Dokument ist dieselbe Datei, die Sie auch anderswo erhalten würden.
In ein fertiges Format exportieren. Übergeben Sie das Dokument an den gebündelten Konverter, der mehr als zwanzig Dokumentformate ausgibt, gruppiert nach ihrem Verwendungszweck:
| Kategorie | Formate |
|---|---|
| E-Books | EPUB 3, FictionBook2 |
| Textverarbeitung | Microsoft Word (.docx), OpenDocument (.odt), Rich Text Format (.rtf) |
| Präsentation | Microsoft PowerPoint (.pptx), reveal.js (.html) |
| Satz | InDesign ICML, LaTeX (.tex), Typst (.typ) |
| XML | DocBook, JATS, OpenDocument XML, TEI Simple |
| Notizbuch | Jupyter Notebook (.ipynb) |
| Gliederung | OPML (.opml) |
Der Konverter ist in Markzen enthalten – es muss nichts zusätzlich heruntergeladen oder konfiguriert werden. Daneben befinden sich drei schnelle Ausgaben in der Symbolleiste: Als PDF speichern und Als HTML speichern exportieren das gerenderte Dokument genau wie in der Vorschau (Stilvorlage, Schriftarten und Erweiterungsfiguren inbegriffen), und Drucken sendet es an einen Drucker. Die Code-Schriftart wird in der exportierten Datei mitgeliefert, sodass ein Codeblock oder ein ASCII-Diagramm auf dem Computer des Lesers so aussieht, wie Sie es gesehen haben, unabhängig davon, ob diese Schriftart installiert ist.
Was übertragen wird und was nicht. Eine Rendering-Erweiterungsfigur bleibt nur dort eine Figur, wo das Zielformat ein Bild aufnehmen kann, sodass ein Dokument Markzen auf zwei Wegen verlässt:
- Als das Dokument, das Sie sehen – die drei soeben beschriebenen Symbolleisten-Ausgaben (PDF, HTML, Druck) und fünf der Formate in der obigen Tabelle: EPUB 3, Microsoft Word (
.docx), OpenDocument (.odt), Microsoft PowerPoint (.pptx) und Rich Text Format (.rtf). Diagramme, Formeln und Noten werden als Bilder geschrieben und kommen intakt an. - Als Quelltext des Dokuments – jedes andere Ziel und jede Konvertierung in eine andere Auszeichnungssprache. Prosa, Überschriften, Listen, Tabellen und Links werden alle konvertiert; ein
mermaid- oderkatex-Block kommt als gewöhnlicher Codeblock an, der den von Ihnen eingegebenen Quelltext enthält, da diese Formate keine Figur für Markzen haben, die sie übergeben könnten.
Ein Dokument, das um Diagramme herum aufgebaut ist, wird daher am besten als PDF, HTML, EPUB, Word, OpenDocument, PowerPoint oder RTF übergeben. LaTeX, Typst, reveal.js und der Rest liefern Ihnen weiterhin das gesamte Dokument – wobei die Quelle jeder Figur an Ort und Stelle bleibt, bereit für die eigenen Werkzeuge dieses Ökosystems.
Exportieren über die Befehlszeile
Markzen funktioniert auch ohne ein Fenster zu öffnen. Übergeben Sie der ausführbaren Datei von Markzen eine Quelldatei und -o mit einem Ausgabepfad, und sie rendert das Dokument und schreibt den Export direkt auf die Festplatte:
markzen.exe report.md -o report.pdf
Die Quelle kann eines der acht Markup-Formate sein, die Markzen liest; die Ausgabe ist eine PDF- oder HTML-Datei, die durch die Erweiterung des Ausgabenamens gewählt wird. Der Export durchläuft dieselbe Rendering-Pipeline wie die App selbst, sodass Diagramme, Formeln und alle anderen Erweiterungsblöcke als Live-Figuren ausgegeben werden. Exporte verwenden die Standard-Stilvorlage und -Schriftarten – die Befehlszeile läuft in einem eigenen sauberen Profil, getrennt von der App, was auch bedeutet, dass sie einwandfrei funktioniert, während Markzen bereits geöffnet ist.
Mehrere Dokumente können in einem Aufruf exportiert werden – geben Sie eine beliebige Anzahl von source -o output-Paaren an, und ein einziger Start rendert sie alle, zu einem Bruchteil der Kosten eines Starts pro Datei:
markzen.exe a.md -o a.pdf b.adoc -o b.html c.rst -o c.pdf
Schriftarten & Aussehen
Markzen wurde entwickelt, um ein Dokument eher gesetzt als generisch aussehen zu lassen. Die Steuerelemente dafür befinden sich zusammen in der Symbolleiste hinter der Schaltfläche Stil und Schriftarten, sodass Sie sie beim Lesen anpassen können; das Thema und die Oberflächensprache finden Sie unter Einstellungen → Anzeige.
Stilvorlage
Stil bietet fünf Vorschaustile: Standard, GitHub, Buch, Modern, Minimal. Die von Ihnen gewählte Vorlage ist auch der Stil, der auf PDF- und HTML-Exporte angewendet wird, sodass sie entscheidet, wie ein geteiltes Dokument gelesen wird – wählen Sie Buch oder Modern für etwas, das Sie weitergeben, Minimal für ablenkungsfreies Lesen. Die Vorlage gestaltet nur die Vorschau, niemals den Editor.
Schriftarten
Drei Auswahlelemente im selben Panel legen eine separate Schriftart für jede Textart fest – Überschrift, Text und Code – was einem Markzen-Dokument das Gefühl gibt, gesetzt zu sein:
- Überschrift – Oswald, Playfair Display, Merriweather, Raleway, Montserrat, Lora, Libre Baskerville, Bebas Neue, Abril Fatface, Cinzel.
- Textkörper – Inter, Roboto, Georgia, Lato, Source Serif 4, Nunito, PT Serif, Crimson Text, Libre Franklin, Open Sans.
- Code – JetBrains Mono, Source Code Pro, Cascadia Mono, Fira Mono.
Die Code-Schriftarten wurden aus einem Grund ausgewählt, der über das Aussehen hinausgeht: Sie alle zeichnen die Kastenliniensymbole (│ ├ └ ─), aus denen Baumlisten und ASCII-Diagramme bestehen, sodass ein in einen Codeblock eingefügter Verzeichnisbaum seine Form behält, anstatt in Lücken zu zerfallen. Es sind auch die ligaturfreien Varianten – eine Schriftart mit Ligaturen zeichnet != als einzelnes ≠ neu, was in einem Code-Editor angenehm ist und in einem Dokument, das zeigen soll, was die Datei tatsächlich aussagt, falsch ist. JetBrains Mono und Source Code Pro werden in Markzen mitgeliefert, sodass sie auf einem Computer funktionieren, der sie noch nie gesehen hat und ohne jegliche Verbindung.
Textgröße
Die Schaltflächen Text vergrößern und Text verkleinern der Symbolleiste ändern die Textgröße.
Thema & Sprache
Unter Einstellungen → Anzeige:
- Thema – Hell oder Dunkel. Standard: Hell.
- Sprache – Die Benutzeroberfläche von Markzen ist in mehr als fünfzig Sprachen übersetzt, einschließlich von rechts nach links geschriebenen Skripten (Arabisch, Hebräisch) und CJK (Chinesisch, Japanisch, Koreanisch).
Kompatibilität
Die Referenztabellen: Was jede Markup-Sprache unterstützt und jede Art von Live-Abbildung, die Markzen zeichnen kann. Hier geht es darum, was wo funktioniert – die Erklärungen finden Sie in den Abschnitten oben.
Was jede Markup-Sprache kann
| Markup-Sprache | Öffnet Dateien mit Endung | Live-Abbildungen | Inhaltsbereich | Formel in einem Satz | Kann nicht ausdrücken |
|---|---|---|---|---|---|
| Markdown | .md, .markdown |
alle | ja | $…$ |
Textausrichtung |
| AsciiDoc | .adoc, .asciidoc, .asc |
alle außer style |
ja | nur Block | durchgestrichen |
| reStructuredText | .rst, .rest |
alle außer style |
ja | $…$ |
durchgestrichen |
| Org | .org |
alle außer style |
ja | $…$ |
links- und rechtsbündige Ausrichtung |
| Textile | .textile |
alle außer style |
ja | nur Block | — |
| Djot | .dj |
alle außer style |
ja | $`…` |
— |
| MediaWiki | .wiki, .mediawiki, .wikitext |
alle außer style |
ja | <math> |
Inline-Code, durchgestrichen, Blockzitat, Textausrichtung |
| BBCode | .bbcode, .bb |
alle außer style |
ja | nur Block | — |
Live-Abbildungen – der style-Block ist die einzige Ausnahme: Er wendet CSS auf das Dokument selbst an,
was nur Markdown unterstützt. Jede andere Art von Abbildung funktioniert in jeder Sprache. In einem BBCode-
Dokument wird der Block [code=mermaid]…[/code] anstelle von Backticks geschrieben; in MediaWiki,
<syntaxhighlight lang="mermaid">…</syntaxhighlight>.
Kann nicht ausdrücken – dies sind Einschränkungen der Markup-Sprachen selbst, nicht von Markzen: Wo eine Sprache keine Notation für etwas hat, bietet Markzen keinen Button dafür an, anstatt einen privaten Dialekt zu schreiben, den nur es selbst zurücklesen könnte. Siehe Formeln innerhalb eines Satzes für die Zeile Mathematik.
Jede Art von Abbildung
Schreiben Sie das Tag nach den öffnenden dreifachen Backticks – ```mermaid – und der Block wird zu einer Abbildung.
| Kategorie | Abbildung | Block-Tag | Anmerkungen |
|---|---|---|---|
| Diagramme | Mermaid | mermaid |
Flussdiagramme, Sequenz, Klasse, Gantt, ER, Zustand |
| Graphviz | graphviz |
die DOT-Sprache | |
| Cytoscape | cytoscape |
Netzwerkdiagramme; Schwenken und Zoomen in der Vorschau | |
| Markmap | markmap |
Mindmap aus einer Gliederung; zum Einklappen klicken | |
| Timeline | timeline |
vertikale Ereigniszeitleiste | |
| Softwarediagramme | Nomnoml | nomnoml |
UML |
| PlantUML | plantuml |
UML – die einzige Abbildung, die eine Internetverbindung benötigt | |
| DBML | dbml |
Datenbankschema-Diagramme | |
| Diagramme | Chart.js | chartjs |
Balken, Linie, Kreis, Radar |
| Vega-Lite | vega-lite |
deklarative Diagramme aus JSON | |
| ECharts | echarts |
große interaktive Diagramme | |
| IT-Entwicklung | Pseudocode | pseudocode |
gesetzte Algorithmen |
| Tabulator | tabulator |
sortierbare interaktive Tabelle | |
| Bytefield | bytefield |
Bit- und Bytefeld-Layouts | |
| QR Code | qrcode |
||
| Railroad | railroad |
Syntaxdiagramme | |
| WaveDrom | wavedrom |
digitale Timing-Diagramme | |
| Mathematik | KaTeX | katex |
auch $…$ in einem Satz – siehe Tabelle oben |
| AsciiMath | asciimath |
Klartext-Mathematiknotation | |
| Graphen | function-plot | fnplot |
eine Funktionskurve zeichnen |
| JSXGraph | jsxgraph |
interaktive Geometrie | |
| Plotly | plotly |
wissenschaftliche und 3D-Diagramme | |
| Wissenschaften | SMILES | smiles |
chemische Strukturdiagramme |
| Musik | ABC Notation | abc |
Noten aus Klartext |
| VexFlow | vexflow |
gravierte Notensysteme | |
| VexChords | vexchords |
Gitarrenakkorddiagramme | |
| ChordPro | chordpro |
Akkorde über Liedtexten | |
| MusicXML | musicxml |
vollständige Partituren | |
| Spiele | Chess | chess |
ein Brett aus einer FEN-Position |
| Go Board | goboard |
9×9, 13×13 und 19×19 | |
| Dokument | Markzen | markzen |
unsichtbar: platziert und skaliert die darunter liegende Abbildung oder überschreibt den Inhaltsbereich |
| Style | style |
unsichtbar: CSS für dieses Dokument – nur Markdown |
Dateizuordnungen
Unter Windows kann das Installationsprogramm Markzen als Handler für jeden von ihm gelesenen Markup-Dateityp registrieren – alle fünfzehn in Kompatibilität aufgeführten Erweiterungen, über alle acht Sprachen hinweg. Nach der Registrierung öffnet ein Doppelklick auf eine dieser Dateien im Explorer diese direkt in Markzen, und wenn mehrere Editoren installiert sind, können Sie Markzen immer noch über „Öffnen mit…“ auswählen.
Tastenkombinationen
| Taste | Aktion |
|---|---|
Strg+S |
Speichern |
Strg+Umschalt+S |
Speichern unter |
Strg+ + / Strg+ - |
Textgröße erhöhen / verringern |
Standard-Editor-Tastenkombinationen – Suchen, Ersetzen, Kopieren, Einfügen, Rückgängig machen, Wiederherstellen – und die Tastenkombinationen der Formatierungsleiste (fett Strg+B, kursiv Strg+I, Überschrift Strg+H, Link Strg+K und mehr) funktionieren im Editorbereich. Eine Formatierungs-Tastenkombination existiert nur dort, wo das aktuelle Markup das Konstrukt enthält – Strg+D bewirkt nichts in einem AsciiDoc-Dokument, das keine eigene Durchstreichung hat (siehe Der Editor).
Tipps
- Editor ausblenden zum Lesen. Die Einzelansicht mit der Vorschau verwandelt Markzen in einen sauberen Reader, und die fünf Stilvorlagen ermöglichen es Ihnen, das Aussehen anzupassen.
- Ein Dokument, jede Art von Inhalt. Ein Mermaid-Flussdiagramm, eine KaTeX-Gleichung und eine Musikpartitur können neben einfachem Text stehen – sie werden alle zusammen gerendert und überleben alle den PDF- und HTML-Export.
- Die Stilvorlage ist das Export-Aussehen. Welche Vorlage Sie auch wählen, ist der Stil, der in die PDF- und HTML-Ausgabe integriert wird, also stellen Sie sie vor dem Export ein.
- Schreiben Sie im Markup Ihrer Wahl, liefern Sie im benötigten Format. Entwerfen Sie in Markdown (oder einem der acht), und verwenden Sie dann „Konvertieren nach“ für eine Word-Datei, eine Präsentation, ein E-Book oder eine LaTeX-Quelle – keine separaten Tools erforderlich.