Markzen Help

Help

Wat is Markzen?

Markzen is een desktop-editor voor lichtgewicht opmaaktalen — Markdown en zes andere — met een live, volledig gestileerde preview. U typt platte tekst opgemaakt met eenvoudige interpunctie aan de linkerkant, en Markzen rendert deze als geformatteerde HTML aan de rechterkant terwijl u typt.

Wat het onderscheidt van een gewone Markdown-editor is de round-trip. Markzen leest acht opmaaktalen, rendert 30 live extensies (diagrammen, grafieken, wiskundige formules, muziekpartituren, schaakborden, QR-codes) in het document, en exporteert naar meer dan twintig formaten — e-boeken, Word, PowerPoint, LaTeX, Jupyter-notebooks en meer. Eén keer schrijven, het resultaat afleveren als bijna alles. De converter is ingebouwd, dus er zijn geen externe tools te installeren.

U kunt een bestaand bestand openen of gewoon beginnen met typen — het is niet nodig om eerst een bestand te openen.

De editor

Het linkerdeelvenster is een volledige CodeMirror code-editor, geen gewoon tekstvak: het heeft syntaxiskleuring voor de opmaak die u schrijft, een opmaakwerkbalk (vet, cursief, koppen, lijsten en meer, plus speciale knoppen voor het invoegen van links en afbeeldingen — zie Links & afbeeldingen — en voor het invoegen van een tabel, zie Tabellen & spreadsheets), en een zoek- en vervangfunctie. Standaard bewerkingssneltoetsen — kopiëren, plakken, ongedaan maken, opnieuw uitvoeren — werken zoals u zou verwachten.

U schrijft in een van acht lichtgewicht opmaaktalen. Dit zijn platte-tekstformaten die structuur uitdrukken met interpunctie (# voor een kop, * voor nadruk) in plaats van verborgen stijlen, zodat een document leesbaar blijft als tekst en diff-vriendelijk is in versiebeheer. Markzen leest alle acht en beslist welke taal een bestand is aan de hand van de extensie — u kiest het formaat nooit handmatig. Compatibiliteit vermeldt welke extensies welke taal openen.

Elke taal heeft zijn eigen conventies en zijn eigen bestaande ecosysteem van documenten; Markzen rendert elke taal in zijn eigen dialect in plaats van alles eerst naar Markdown te converteren. BBCode is de enige zonder een enkele standaard — elk forum heeft zijn eigen variant uitgevonden — dus Markzen leest het genereus, accepteert de gangbare spellingen naast elkaar ([list] of [ul], [h1] of [heading=1]) en laat elke tag die het niet herkent zichtbaar als platte tekst in plaats van deze te negeren. Om het soort opmaak waarin een document is geschreven te wijzigen, gebruikt u het Converteren naar menu van de werkbalk (zie Converteren & exporteren hieronder).

Niet elke taal kan alles uitdrukken. De opmaakwerkbalk bevat dezelfde knoppen in elk document, maar Markzen schrijft alleen opmaak die de taal zelf definieert — het verzint nooit een privé-dialect om een leemte op te vullen. Een knop waarvoor de huidige taal geen notatie heeft, is grijs. Vet, cursief, koppen, lijsten, codeblokken, links, afbeeldingen, regels en tabellen zijn beschikbaar in alle acht; de handvol hiaten worden vermeld in Compatibiliteit. Markdown is degene die mensen verrast: het heeft geen standaard manier om een paragraaf te centreren, dus Markzen biedt daar geen uitlijnknoppen in plaats van iets te schrijven dat slechts sommige lezers zouden honoreren.

De tekstgrootte wordt ingesteld met de Tekst vergroten en Tekst verkleinen knoppen van de werkbalk. Het editorvenster kan ook volledig worden verborgen — wanneer dit het geval is, wordt Markzen een pure lezer (zie Livevoorbeeld).

De opmaakwerkbalk heeft twee speciale knoppen om een link of een afbeelding in het document te plaatsen, en elk opent een kleine pop-up precies waar uw cursor staat. Koppeling (Ctrl+K) — of druk op Ctrl+K — voegt een hyperlink in: typ de linktekst en het adres, en Markzen schrijft de juiste opmaak ervoor. Afbeelding voegt op dezelfde manier een afbeelding in, met een paar extra keuzes die hieronder worden behandeld.

Beide worden geschreven in de opmaak die het huidige document gebruikt — een link ingevoegd in een AsciiDoc-bestand komt eruit als AsciiDoc, in een Org-bestand als Org, enzovoort in alle acht talen.

Beginnen met een adres dat u al hebt. Plak een webadres in het document, selecteer het en druk op Ctrl+K: Markzen ziet dat de selectie een adres is in plaats van woorden, plaatst het in het adresveld van de pop-up en laat de cursor in het lege tekstveld staan, wachtend op wat de link moet zeggen. Zonder dat zou een geselecteerd adres de zichtbare tekst van de link zijn geworden — een link die leest als een kale URL. Absolute bestandspaden tellen ook als adressen, op Windows en elders, dus dezelfde sneltoets verandert een geplakt pad in een link naar dat bestand.

Een bestaande link of afbeelding bewerken. Plaats de cursor ergens op een bestaande link of afbeelding en open de pop-up opnieuw (de knop, of Ctrl+K): Markzen herkent de constructie, laadt de huidige tekst en het adres in de pop-up, en vervangt het geheel wanneer u bevestigt — zo bewerkt u het ter plekke in plaats van per ongeluk een nieuwe link in de oude te nesten.

Voor een afbeelding biedt de pop-up ook een Afbeelding zoeken-knop om een bestand van de schijf te kiezen in plaats van een pad te typen — deze opent in de map waaruit u het laatst een afbeelding hebt gehaald, apart gehouden van de map waar uw documenten vandaan komen — en een belangrijke keuze: of de afbeelding is ingebed of gekoppeld.

Ingebouwde of gekoppelde afbeeldingen

Wanneer u een afbeelding invoegt, kan Markzen deze op twee manieren in het document opslaan:

  • Gekoppeld — het document verwijst alleen naar de afbeelding, via bestandspad of webadres. Het documentbestand blijft klein, maar de afbeelding moet meereizen (of bereikbaar blijven via de URL), anders verschijnt deze elders niet. Dit is de standaard.
  • Ingebed — de daadwerkelijke bytes van de afbeelding worden in het document geschreven als tekst (een base64 data: codeblok), zodat het bestand volledig zelfstandig is: één bestand bevat alles, zonder iets kwijt te raken. De afweging is de grootte — het document groeit met het gewicht van de afbeelding, en een ingebedde afbeelding kan geen relatief pad gebruiken.

Kies Ingebouwd wanneer u een enkel draagbaar bestand wilt overdragen; kies Gekoppeld wanneer u afbeeldingen naast het document bewaart en het bestand klein wilt houden.

Voor een gekoppelde afbeelding verschijnt nog een optie: Relatief pad. Wanneer de afbeelding zich in de eigen map van het document bevindt (of een submap), schrijft het aanvinken hiervan de verwijzing als een kort relatief pad in plaats van een volledig absoluut pad, zodat de link blijft werken wanneer u het document en de afbeeldingen samen verplaatst. Het wordt alleen aangeboden wanneer de afbeelding zich in de map van het document bevindt — anders is er geen relatief pad om te schrijven.

Ingebouwde afbeeldingen blijven netjes in de editor. Een base64-ingebedde afbeelding is een lange muur van tekst die anders de omringende regels zou begraven, dus Markzen vouwt elk ervan op tot een kleine chip die het type en de grootte toont (bijvoorbeeld 🖼 webp · 38 KB). De chip is alleen voor weergave — de onderliggende tekst blijft onaangeroerd, dus opslaan, kopiëren of knippen draagt altijd de volledige afbeelding, en de cursor springt over de chip als een enkele eenheid.

Bestanden, tabbladen en opslaan

Markzen houdt zoveel documenten tegelijk open als u wilt, elk in een eigen tabblad, zodat u in meerdere bestanden kunt werken en er vrijelijk tussen kunt schakelen. U hoeft geen bestand te openen om te beginnen — begin te typen in het lege document dat er al is, of gebruik de bestandsbuttons van de werkbalk:

  • Nieuw document — opent een kort menu (Een nieuwe maken) met de acht opmaaktalen; kies er een om een nieuw, leeg document in die opmaak te starten, in een nieuw tabblad.
  • Open een Markdown-bestand — blader naar een bestaand bestand en open het. De kiezer accepteert alle acht opmaakformaten, en Markzen kiest de juiste op basis van de bestandsextensie. Het opent in de map waaruit u het laatst een document hebt gehaald, onthouden tussen sessies, zodat u niet elke keer opnieuw hoeft te beginnen.
  • Opslaan — schrijft het actieve document terug naar het bestand. Een document dat nog nooit is opgeslagen, valt terug op Opslaan als, zodat u het eerst een naam kunt geven.
  • Opslaan als — slaat het actieve document op als een nieuw bestand, waarbij het origineel onaangeroerd blijft.

U kunt ook een bestand uit uw bestandsbeheerder slepen en op het venster neerzetten om het te openen.

Elk geopend document is een tabblad bovenaan het venster. Een niet-opgeslagen tabblad is gemarkeerd met een stip, en een tabblad waarvan de opmaak geen Markdown is, heeft een kleine formaatbadge (bijvoorbeeld adoc). De × op een tabblad sluit het — en het sluiten van een document met niet-opgeslagen wijzigingen verwijdert deze nooit stilzwijgend: er verschijnt een inline balk op het tabblad zodat u eerst kunt Opslaan of Verwijderen.

Terwijl een document open is, bewaakt Markzen het bestand op schijf. Als het bestand in een ander programma verandert en u geen eigen niet-opgeslagen bewerkingen hebt, haalt Markzen de nieuwe versie automatisch binnen; als u wel niet-opgeslagen bewerkingen hebt, vraagt het eerst — een inline Herladen balk laat u beslissen of u de versie op schijf wilt nemen of uw eigen versie wilt behouden.

Livevoorbeeld

Het rechterdeelvenster is het document weergegeven als gestileerde HTML, live bijgewerkt terwijl u typt. Links werken, tabellen worden uitgelijnd, code wordt weergegeven in een monospace codeblok, takenlijsten krijgen selectievakjes en elk rendering-extensieblok (zie hieronder) tekent zijn figuur op zijn plaats. Het voorbeeld is een getrouwe weergave van hoe een HTML- of PDF-export eruit zal zien.

Als een Markdown-document opent met een YAML front-matter blok — het --- key: value --- gedeelte dat tools zoals Jekyll, Hugo en Obsidian helemaal bovenaan plaatsen — rendert Markzen het als een nette metadatakaart boven het document, in plaats van de afsluitende --- te laten veranderen in een losse kop.

Lay-outmodi

Een groep van drie werkbalkknoppen bepaalt wat het venster toont:

  • Gesplitste weergave — editor en voorbeeld naast elkaar. Sleep de scheidingslijn om te wijzigen hoeveel ruimte elk krijgt.
  • Editor tonen — alleen de editor, vult het venster voor afleidingsvrij schrijven.
  • Voorbeeld tonen — alleen het voorbeeld, een schone, volledig brede lezer.

Inhoudsopgave

De knop Inhoudsopgave opent een paneel dat automatisch wordt opgebouwd uit elke kop in het document (#, ##, ###, …). Klik op een item om het voorbeeld naar die sectie te scrollen. Elke kop met subkoppen eronder toont een chevron: klik erop om die sectie te Samenvouwen en de geneste koppen te verbergen, of Uitvouwen om ze terug te brengen — zodat u een lange outline kunt inklappen tot alleen de delen waaraan u werkt. De kleine 2 / 3 / 4 knoppen in de paneelkop beperken de outline tot die kopdiepte — handig in een lang document wanneer u alleen de bovenste niveaus in beeld wilt hebben — en opnieuw klikken op de actieve knop brengt elk niveau terug. Het paneel wordt aangepast door de linkerrand te slepen en klapt in om leesruimte vrij te maken. Het is alleen een navigatiehulpmiddel binnen de app — het verschijnt nooit in een export.

Uw eigen outline aanleveren. Als de koppen niet de outline zijn die u wilt, kan een document zijn eigen outline meenemen. Een codeblok getagd met markzen waarvan de eerste regel toc is, vervangt het gegenereerde paneel door de lijst die eronder is geschreven:

`markdown

```markzen
toc
- [Introduction](#intro)
  - [Background](#background)
- [Results](#results)
```

Inspringing bepaalt het niveau, en elke vermelding verwijst naar een anker dat in het document zelf moet bestaan — een kop waaraan u een expliciete id hebt gegeven, of een gewone <a id="intro"></a>. Het blok zelf tekent niets: het is metadata die het paneel leest.

Tabellen & spreadsheets

Tabellen kunnen gemakkelijk worden verplaatst tussen Markzen en elke spreadsheet. Plak tab-gescheiden tekst — gekopieerd uit Excel, Google Sheets, Word of een web-tabel — in de editor en Markzen zet het om in een correcte tabel, geschreven in de eigen opmaak van het document, in plaats van een muur van tab-tekens te plaatsen. De plaklezer is citaat-bewust (het verwerkt correct cellen die zelf tabs, regeleinden of aanhalingstekens bevatten) en wordt alleen geactiveerd wanneer het klembord een schoon rechthoekig raster van ten minste twee kolommen bevat; al het andere wordt geplakt als gewone tekst.

U kunt ook een tabel helemaal opnieuw beginnen. De knop Tabel invoegen op de werkbalk opent een klein raster — veeg eroverheen om te kiezen hoeveel rijen en kolommen u wilt, en Markzen schrijft een lege tabel van die grootte in de eigen opmaak van het document, klaar om in te typen. De eerste rij is de koptekstrij.

Het omgekeerde werkt ook. Beweeg de muis over een weergegeven tabel in de preview en er verschijnt een kopieerknop in de hoek: deze kopieert de tabel terug als tab-gescheiden tekst die direct in een spreadsheetcel of een Word-document kan worden geplakt. Deze kopieerknoppen zijn alleen voor het gemak van de preview — ze worden verwijderd bij elke export en conversie, dus een gedeeld bestand bevat alleen de schone tabel.

Rendering-extensies

Markzen breidt standaardopmaak uit via codeblokken. De taaltag direct na de openings-triple-backticks bepaalt hoe het blok wordt weergegeven: een tag die Markzen herkent als een extensie, tekent een live figuur in plaats van de code te tonen.

Elke soort figuur wordt getekend door zijn eigen rendering-engine, en Markzen haalt een engine op de eerste keer dat een document er daadwerkelijk om vraagt, in plaats van ze allemaal bij de lancering te laden — daarom start de app bijna onmiddellijk, en daarom kan het eerste diagram van een bepaalde soort even duren voordat het verschijnt, terwijl elk later diagram onmiddellijk is.

Bijvoorbeeld, deze bron:

```mermaid
graph LR
  A --> B --> C
```

wordt weergegeven als een live stroomdiagram, niet als een codelijst — en het blijft ook een stroomdiagram in PDF- en HTML-exports.

Diagrammen, grafieken, wiskunde, muzieknotatie, schaak- en Go-borden, QR-codes en meer zijn ingebouwd — Compatibiliteit vermeldt ze allemaal met hun tag.

Elke extensie heeft zijn eigen taaltag (mermaid, chartjs, katex, abc, chess, …). Je kunt er zoveel als je wilt combineren met gewone tekst in één document — ze worden allemaal samen weergegeven. Of een figuur nog steeds een figuur is zodra het document Markzen verlaat, hangt af van waar je het naartoe stuurt — zie Converteren & exporteren hieronder.

Formules in een zin

Een wiskundige formule kan een blok op zich zijn — een katex- of asciimath-blok, dat op zichzelf staat en gecentreerd is als een vergelijking in een leerboek. Dat werkt in alle acht opmaaktalen.

Een formule kan ook in een zin staan, zodat "de oppervlakte is pi r kwadraat" als één regel tekst met echte symbolen erin wordt gelezen. Dat hangt af van de opmaaktaal die er een notatie voor heeft, en elke taal spelt het anders — de notatie per taal staat in Compatibiliteit.

Textile en BBCode zijn de twee uitzonderingen, en het is een beperking van die talen in plaats van Markzen: geen van beide heeft ooit een manier gedefinieerd om wiskunde te schrijven. In een Textile- of BBCode-document moet een formule daarom een blok op zich zijn. Er gaat niets verloren — de formule wordt weergegeven en overleeft de export — het kan gewoon niet in een regel tekst worden verweven.

Een figuur plaatsen en de grootte aanpassen

Beweeg de muis over een weergegeven figuur in de preview en er verschijnt een klein paneel ernaast: uitlijning-knoppen (links, midden, rechts) en — voor de soorten figuren waarvan de grootte kan worden aangepast — breedte- en hoogte-vakken in pixels. remove style block wist ze weer.

Die keuze wordt niet ergens onzichtbaar bewaard: het paneel schrijft het in het document, als een kort blok met de tag markzen direct vóór de figuur waarop het van toepassing is.

```markzen
style
align center
width 480
```

De lay-out reist dus mee met het bestand — het is onderdeel van wat je opslaat, overdraagt en exporteert, op elke machine. Je kunt het blok ook handmatig schrijven: één richtlijn per regel, align (left, center of right), width en height in pixels, altijd van toepassing op het blok direct eronder.

Eén document stylen met CSS

Een Markdown-document kan ook zijn eigen stylesheet bevatten, in een codeblok met de tag style:

```style
h2 { color: #b03030; border-bottom: 2px solid #b03030; }
blockquote { font-style: italic; }
```

De regels zijn van toepassing op de preview van dat document en op de PDF- en HTML-exports, bovenop de actieve stijl sjabloon — een manier om één document een eigen uiterlijk te geven zonder je instellingen voor al het andere te wijzigen. Alleen gewone selectors: at-rules zoals @media en @keyframes worden niet ondersteund, en het blok werkt alleen in Markdown-documenten.

Converteren en exporteren

Het menu Converteren naar van de werkbalk is de plek waar een voltooid document Markzen verlaat. Het doet twee verschillende dingen.

Converteren naar een andere opmaaktaal. Onder Lichte opmaak wordt het geopende document herschreven als een van de andere zeven opmaaktalen — AsciiDoc, BBCode, Djot, MediaWiki, Org, reStructuredText of Textile. Handig wanneer een wiki MediaWiki wil, een forum BBCode wil, een uitgever AsciiDoc wil, of wanneer u notities tussen ecosystemen verplaatst. Elk van de acht verschijnt één keer in het menu, als een opmaaktaal: een document dat hiervandaan als MediaWiki is opgeslagen, is hetzelfde bestand dat u elders zou krijgen.

Exporteren naar een voltooid formaat. Geef het document aan de gebundelde converter, die meer dan twintig documentformaten uitvoert, gegroepeerd op waarvoor ze zijn:

Categorie Formaten
E-boeken EPUB 3, FictionBook2
Tekstverwerker Microsoft Word (.docx), OpenDocument (.odt), Rich Text Format (.rtf)
Presentatie Microsoft PowerPoint (.pptx), reveal.js (.html)
Zetwerk InDesign ICML, LaTeX (.tex), Typst (.typ)
XML DocBook, JATS, OpenDocument XML, TEI Simple
Notitieboek Jupyter Notebook (.ipynb)
Overzicht OPML (.opml)

De converter wordt meegeleverd in Markzen — niets extra's om te downloaden of te configureren. Daarnaast staan er drie snelle uitvoeropties op de werkbalk: Opslaan als PDF en Opslaan als HTML exporteren het gerenderde document precies zoals het is voorvertoond (stijlsjabloon, lettertypen en extensiefiguren inbegrepen), en Afdrukken stuurt het naar een printer. Het codelettertype reist binnen het geëxporteerde bestand, zodat een codeblok of een ASCII-diagram op de machine van de lezer eruitziet zoals u het zag, ongeacht of zij dat lettertype hebben geïnstalleerd.

Wat wel en niet meereist. Een rendering-extensiefiguur blijft alleen een figuur waar het doelformaat een afbeelding kan bevatten, dus een document verlaat Markzen via een van de twee routes:

  • Als het document dat u ziet — de drie hierboven beschreven werkbalkuitvoer (PDF, HTML, afdrukken) en vijf van de formaten in de bovenstaande tabel: EPUB 3, Microsoft Word (.docx), OpenDocument (.odt), Microsoft PowerPoint (.pptx) en Rich Text Format (.rtf). Diagrammen, formules en partituren worden als afbeeldingen geschreven en komen intact aan.
  • Als de brontekst van het document — elk ander doel, en elke conversie naar een andere opmaaktaal. Proza, koppen, lijsten, tabellen en links worden allemaal geconverteerd; een mermaid- of katex-blok komt aan als een gewoon codeblok met de bron die u hebt getypt, omdat die formaten geen figuur hebben die Markzen kan overhandigen.

Dus een document dat is opgebouwd rond diagrammen kan het beste worden overgedragen als PDF, HTML, EPUB, Word, OpenDocument, PowerPoint of RTF. LaTeX, Typst, reveal.js en de rest geven u nog steeds het hele document — met de bron van elke figuur op zijn plaats, klaar voor de eigen tools van dat ecosysteem.

Exporteren vanaf de opdrachtregel

Markzen werkt ook zonder een venster te openen. Geef het uitvoerbare bestand van Markzen een bronbestand en -o met een uitvoerpad, en het rendert het document en schrijft de export direct naar schijf:

markzen.exe report.md -o report.pdf

De bron kan een van de acht opmaakformaten zijn die Markzen leest; de uitvoer is een PDF- of een HTML-bestand, gekozen door de extensie van de uitvoernaam. De export doorloopt dezelfde rendering als de app zelf, dus diagrammen, formules en elk ander extensieblok komen eruit als live figuren. Exports gebruiken de standaard stijl sjabloon en lettertypen — de opdrachtregel draait in zijn eigen schone profiel, gescheiden van de app, wat ook betekent dat het prima werkt terwijl Markzen al open is.

Meerdere documenten kunnen in één aanroep worden geëxporteerd — geef een willekeurig aantal bron -o uitvoer paren en een enkele lancering rendert ze allemaal, tegen een fractie van de kosten van één lancering per bestand:

markzen.exe a.md -o a.pdf b.adoc -o b.html c.rst -o c.pdf

Lettertypen en weergave

Markzen is gebouwd om een document er opgemaakt uit te laten zien in plaats van generiek. De bedieningselementen daarvoor bevinden zich samen op de werkbalk achter de knop Stijl en lettertypen, zodat u ze kunt aanpassen terwijl u leest; het thema en de interfacetaal bevinden zich in Instellingen → Weergave.

Stijlsjabloon

Stijl biedt vijf voorvertoningsstijlen: Standaard, GitHub, Boek, Modern, Minimaal. Het sjabloon dat u kiest, is ook de stijl die wordt toegepast op PDF- en HTML-exports, dus het bepaalt hoe een gedeeld document leest — kies Boek of Modern voor iets dat u zult overhandigen, Minimaal voor afleidingsvrij lezen. Het sjabloon stileert alleen de voorvertoning, nooit de editor.

Lettertypen

Drie kiezers in hetzelfde paneel stellen een apart lettertype in voor elk type tekst — Koptekst, Tekst en Code — wat een Markzen-document opgemaakt doet aanvoelen:

  • Kop — Oswald, Playfair Display, Merriweather, Raleway, Montserrat, Lora, Libre Baskerville, Bebas Neue, Abril Fatface, Cinzel.
  • Tekst — 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.

De codelettertypen zijn gekozen om één eigenschap naast het uiterlijk: ze tekenen allemaal de lijntekeningtekens (│ ├ └ ─) waaruit boomlijsten en ASCII-diagrammen zijn opgebouwd, zodat een directoryboom die in een codeblok is geplakt, zijn vorm behoudt in plaats van in gaten te breken. Het zijn ook de ligaturevrije varianten — een lettertype met ligaturen tekent != opnieuw als een enkele , wat prettig is in een code-editor en verkeerd in een document dat bedoeld is om te laten zien wat het bestand daadwerkelijk zegt. JetBrains Mono en Source Code Pro worden meegeleverd met Markzen, dus ze werken op een machine die ze nog nooit heeft gezien en zonder enige verbinding.

Tekstgrootte

De knoppen Tekst vergroten en Tekst verkleinen op de werkbalk wijzigen de tekstgrootte.

Thema & taal

In Instellingen → Weergave:

  • ThemaLicht of Donker. Standaard: Licht.
  • Taal — De eigen interface van Markzen is vertaald in meer dan vijftig talen, inclusief rechts-naar-links scripts (Arabisch, Hebreeuws) en CJK (Chinees, Japans, Koreaans).

Compatibiliteit

De referentietabellen: wat elke opmaaktaal ondersteunt, en elk soort live figuur dat Markzen kan tekenen. Alles hier gaat over wat waar werkt — de verklaringen staan in de bovenstaande secties.

Wat elke opmaaktaal kan doen

Opmaaktaal Opent bestanden die eindigen op Live figuren Inhoudspaneel Formule in een zin Kan niet uitdrukken
Markdown .md, .markdown alle ja $…$ tekstuitlijning
AsciiDoc .adoc, .asciidoc, .asc alle behalve style ja alleen blok doorhaling
reStructuredText .rst, .rest alle behalve style ja $…$ doorhaling
Org .org alle behalve style ja $…$ links- en rechtsuitlijning
Textile .textile alle behalve style ja alleen blok
Djot .dj alle behalve style ja $`…`
MediaWiki .wiki, .mediawiki, .wikitext alle behalve style ja <math> inline code, doorhaling, blockquote, tekstuitlijning
BBCode .bbcode, .bb alle behalve style ja alleen blok

Live figuren — het style-blok is de enige uitzondering: het past CSS toe op het document zelf, wat alleen Markdown ondersteunt. Elk ander soort figuur werkt in elke taal. In een BBCode-document wordt het blok geschreven als [code=mermaid]…[/code] in plaats van met backticks; in MediaWiki, <syntaxhighlight lang="mermaid">…</syntaxhighlight>.

Kan niet uitdrukken — dit zijn beperkingen van de opmaaktalen zelf, niet van Markzen: waar een taal geen notatie heeft voor iets, biedt Markzen er geen knop voor aan in plaats van een privé-dialect te schrijven dat alleen het zelf zou kunnen teruglezen. Zie Formules in een zin voor de rij wiskunde.

Elk soort figuur

Schrijf de tag na de openingsdrie dubbele backticks — ```mermaid — en het blok wordt een figuur.

Categorie Figuur Bloktag Notities
Diagrammen Mermaid mermaid stroomschema's, sequentie, klasse, Gantt, ER, status
Graphviz graphviz de DOT-taal
Cytoscape cytoscape netwerkgrafieken; pannen en zoomen in de preview
Markmap markmap mindmap van een opsomming; klik om in te klappen
Timeline timeline verticale gebeurtenistijdlijn
Softwarediagrammen Nomnoml nomnoml UML
PlantUML plantuml UML — de enige figuur die een internetverbinding nodig heeft
DBML dbml databaseschemadiagrammen
Grafieken Chart.js chartjs staaf, lijn, cirkel, radar
Vega-Lite vega-lite declaratieve grafieken van JSON
ECharts echarts grote interactieve grafieken
IT-ontwikkeling Pseudocode pseudocode opgemaakte algoritmen
Tabulator tabulator sorteerbare interactieve tabel
Bytefield bytefield bit- en byteveldindelingen
QR Code qrcode
Railroad railroad syntaxisdiagrammen
WaveDrom wavedrom digitale timingdiagrammen
Wiskunde KaTeX katex ook $…$ in een zin — zie de tabel hierboven
AsciiMath asciimath platte tekst wiskundenotatie
Grafieken function-plot fnplot plot een functiecurve
JSXGraph jsxgraph interactieve geometrie
Plotly plotly wetenschappelijke en 3D-grafieken
Wetenschappen SMILES smiles chemische structuurdiagrammen
Muziek ABC Notation abc bladmuziek van platte tekst
VexFlow vexflow gegraveerde notenbalken
VexChords vexchords gitaarakkoorddiagrammen
ChordPro chordpro akkoorden boven songteksten
MusicXML musicxml volledige partituren
Spellen Chess chess een bord van een FEN-positie
Go Board goboard 9×9, 13×13 en 19×19
Document Markzen markzen onzichtbaar: plaatst en schaalt de figuur eronder, of overschrijft het inhoudspaneel
Style style onzichtbaar: CSS voor dit document — alleen Markdown

Bestandskoppelingen

Op Windows kan het installatieprogramma Markzen registreren als een handler voor elk type opmaakbestand dat het leest — alle vijftien extensies vermeld in Compatibiliteit, in alle acht talen. Eenmaal geregistreerd, opent dubbelklikken op een van die bestanden in Verkenner het direct in Markzen, en als er meerdere editors zijn geïnstalleerd, kunt u Markzen nog steeds kiezen via "Openen met…".

Toetsenbordsneltoetsen

Toets Actie
Ctrl+S Opslaan
Ctrl+Shift+S Opslaan als
Ctrl+ + / Ctrl+ - Tekstgrootte vergroten / verkleinen

Standaard sneltoetsen van de editor — zoeken, vervangen, kopiëren, plakken, ongedaan maken, opnieuw uitvoeren — en de sneltoetsen van de opmaakwerkbalk (vet Ctrl+B, cursief Ctrl+I, kop Ctrl+H, link Ctrl+K, en meer) werken in het editorvenster. Een opmaaksneltoets bestaat alleen waar de huidige opmaak de constructie heeft — Ctrl+D doet niets in een AsciiDoc-document, dat geen eigen doorhaling heeft (zie De editor).

Tips

  • Verberg de editor om te lezen. Eén weergave met de preview maakt van Markzen een schone lezer, en de vijf stijlsjablonen laten u instellen hoe het eruitziet.
  • Eén document, elk soort inhoud. Een Mermaid-stroomdiagram, een KaTeX-vergelijking en een muziekpartituur kunnen naast gewone tekst staan — ze worden allemaal samen weergegeven en overleven allemaal de PDF- en HTML-export.
  • Het stijlsjabloon is de exportlook. Welk sjabloon u ook kiest, dat is de stijl die in de PDF- en HTML-uitvoer wordt gebakken, dus stel dit in voordat u exporteert.
  • Schrijf in de opmaak die u wilt, lever in het formaat dat zij nodig hebben. Ontwerp in Markdown (of een van de acht), gebruik vervolgens Converteren naar voor een Word-bestand, een presentatie, een e-boek of een LaTeX-bron — geen aparte tools nodig.
Inhoud