Súgó

Mi az a Markzen?

A Markzen egy asztali szerkesztő könnyű jelölőnyelvekhez – Markdown és hat másik – élő, teljesen stílusos előnézettel. A bal oldalon egyszerű írásjelekkel jelölt sima szöveget ír, és a Markzen formázott HTML-ként jeleníti meg a jobb oldalon, ahogy gépel.

Ami megkülönbözteti egy közönséges Markdown szerkesztőtől, az a oda-vissza út. A Markzen nyolc jelölőnyelvet olvas, 30 élő kiterjesztést (diagramok, grafikonok, matematikai képletek, kották, sakktáblák, QR-kódok) jelenít meg a dokumentumon belül, és exportál több mint húsz formátumba – e-könyvek, Word, PowerPoint, LaTeX, Jupyter jegyzetfüzetek és még sok más. Írja meg egyszer, és adja át az eredményt szinte bármilyen formátumban. A konverter be van építve, így nincs szükség külső eszközök telepítésére.

Megnyithat egy meglévő fájlt, vagy egyszerűen elkezdhet gépelni – nem szükséges először fájlt megnyitni.

A szerkesztő

A bal oldali panel egy teljes CodeMirror kódszerkesztő, nem egy egyszerű szövegmező: szintaxiskiemeléssel rendelkezik az írt jelöléshez, formázási eszköztárral (félkövér, dőlt, címsorok, listák és még sok más, plusz dedikált gombok a hivatkozások és képek beszúrásához – lásd Hivatkozások és képek – és táblázat beszúrásához – lásd Táblázatok és táblázatkezelők), valamint keresés és csere funkcióval. A szokásos szerkesztési parancsikonok – másolás, beillesztés, visszavonás, ismétlés – a várakozásoknak megfelelően működnek.

Nyolc könnyű jelölőnyelv egyikén írhat. Ezek egyszerű szöveges formátumok, amelyek írásjelekkel fejezik ki a struktúrát (# címsorhoz, * kiemeléshez) rejtett stílusok helyett, így a dokumentum szövegként olvasható marad, és verziókezelésben könnyen összehasonlítható. Az Markzen mind a nyolcat olvassa, és a fájl kiterjesztése alapján dönti el, melyikről van szó – soha nem választja ki manuálisan a formátumot. A Kompatibilitás felsorolja, mely kiterjesztések mely nyelvet nyitják meg.

Minden nyelvnek megvannak a saját konvenciói és a saját meglévő dokumentum-ökoszisztémája; az Markzen mindegyiket a saját dialektusában rendereli, ahelyett, hogy először mindent Markdownra konvertálna. A BBCode az egyetlen, amelynek nincs egységes szabványa – minden fórum kitalálta a saját változatát –, így az Markzen nagylelkűen olvassa, elfogadva a gyakori írásmódokat egymás mellett ([list] vagy [ul], [h1] vagy [heading=1]), és minden olyan címkét, amelyet nem ismer fel, egyszerű szövegként láthatóan hagy, ahelyett, hogy elnyelné. A dokumentum írásához használt jelölés típusának váltásához használja az eszköztár Konvertálás menüjét (lásd alább a Konvertálás és exportálás részt).

Nem minden nyelv képes mindent kifejezni. A formázási eszköztár ugyanazokat a gombokat tartalmazza minden dokumentumban, de az Markzen mindig csak olyan jelölést ír, amelyet maga a nyelv definiál – soha nem talál ki privát dialektust egy hiányosság áthidalására. Egy gomb, amelyhez az aktuális nyelvnek nincs jelölése, szürkén jelenik meg. A félkövér, dőlt, címsorok, listák, kódblokkok, hivatkozások, képek, vonalak és táblázatok mind a nyolcban elérhetők; a néhány hiányosságot a Kompatibilitás sorolja fel. A Markdown az, ami meglepi az embereket: nincs szabványos módja egy bekezdés középre igazításának, így az Markzen nem kínál igazítási gombokat, ahelyett, hogy olyat írna, amit csak néhány olvasó fogadna el.

A szövegméretet az eszköztár Betűméret növelése és Betűméret csökkentése gombjaival állíthatja be. A szerkesztőpanel teljesen el is rejthető – ekkor az Markzen tiszta olvasóvá válik (lásd Élő előnézet).

Hivatkozások és képek

A formázási eszköztáron két dedikált gomb található a hivatkozások és képek dokumentumba illesztéséhez, és mindegyik egy kis felugró ablakot nyit meg közvetlenül a kurzor helyén. A Hivatkozás (Ctrl+K) – vagy nyomja meg a Ctrl+K billentyűkombinációt – hiperhivatkozást szúr be: írja be a hivatkozás szövegét és címét, és az Markzen megírja hozzá a megfelelő jelölést. A Kép ugyanígy szúr be egy képet, néhány további választási lehetőséggel, amelyeket alább ismertetünk.

Mindkettő az aktuális dokumentum által használt jelöléssel íródik – egy AsciiDoc fájlba beszúrt hivatkozás AsciiDoc formátumban jelenik meg, egy Org fájlba beszúrt hivatkozás Org formátumban, és így tovább mind a nyolc nyelven.

Már meglévő címről indulva. Illesszen be egy webcímet a dokumentumba, jelölje ki, majd nyomja meg a Ctrl+K billentyűkombinációt: az Markzen látja, hogy a kijelölés cím, nem pedig szavak, beírja a felugró ablak címmezőjébe, és a kurzort az üres szövegmezőben hagyja, várva, hogy mit mondjon a hivatkozás. Enélkül egy kijelölt cím a hivatkozás látható szövegévé vált volna – egy hivatkozás, amely csupasz URL-ként olvasható. Az abszolút fájlútvonalak is címnek számítanak, Windows-on és máshol is, így ugyanaz a parancsikon egy beillesztett útvonalat az adott fájlra mutató hivatkozássá alakít.

Már meglévő hivatkozás vagy kép szerkesztése. Helyezze a kurzort egy meglévő hivatkozásra vagy képre, és nyissa meg újra a felugró ablakot (a gombbal, vagy a Ctrl+K billentyűkombinációval): az Markzen felismeri a szerkezetet, betölti az aktuális szövegét és címét a felugró ablakba, és megerősítéskor lecseréli az egészet – így a helyén szerkeszti, ahelyett, hogy véletlenül új hivatkozást ágyazna a régi belsejébe.

Kép esetén a felugró ablak egy Kép keresése gombot is kínál, amellyel fájlt választhat a lemezről az útvonal beírása helyett – ez abban a mappában nyílik meg, ahonnan utoljára képet vett, külön tartva attól, ahonnan a dokumentumai származnak –, és egy fontos választási lehetőséget: hogy a kép beágyazott vagy hivatkozott legyen.

Beágyazott vagy hivatkozott képek

Amikor képet szúr be, az Markzen kétféleképpen tárolhatja a dokumentumban:

• Hivatkozott – a dokumentum csak rámutat a képre, fájlútvonal vagy webcím alapján. A dokumentumfájl kicsi marad, de a képnek vele kell utaznia (vagy elérhetőnek kell maradnia az URL-jén), különben máshol nem jelenik meg. Ez az alapértelmezett.
• Beágyazott – a kép tényleges bájtjai beleíródnak a dokumentumba szövegként (egy base64 data: blokk), így a fájl teljesen önálló: egy fájl mindent tartalmaz, anélkül, hogy bármit is elveszítene. A kompromisszum a méret – a dokumentum a kép súlyával nő, és egy beágyazott kép nem használhat relatív útvonalat.

Válassza a Beágyazott lehetőséget, ha egyetlen hordozható fájlt szeretne átadni; válassza a Hivatkozott lehetőséget, ha a képeket a dokumentum mellett tartja, és azt szeretné, hogy a fájl kicsi maradjon.

Hivatkozott kép esetén egy további opció jelenik meg: Relatív elérési út. Ha a kép a dokumentum saját mappájában (vagy egy almappájában) található, ennek bejelölése rövid relatív útvonalként írja be a hivatkozást a teljes abszolút útvonal helyett, így a hivatkozás továbbra is működik, ha a dokumentumot és a képeit együtt mozgatja. Csak akkor kínálja fel, ha a kép a dokumentum mappájában van – különben nincs relatív útvonal, amit beírhatna.

A beágyazott képek rendezettek maradnak a szerkesztőben. Egy base64-beágyazott kép egy hosszú szövegfal, amely egyébként eltemetné a körülötte lévő sorokat, ezért az Markzen mindegyiket egy kis chipbe hajtja, amely megmutatja a típusát és méretét (például 🖼 webp · 38 KB). A chip csak megjelenítésre szolgál – az alapul szolgáló szöveg érintetlen marad, így a mentés, másolás vagy kivágás mindig a teljes képet viszi magával, és a kurzor egyetlen egységként ugrik át a chipen.

Fájlok, lapok és mentés

Az Markzen tetszőleges számú dokumentumot tart nyitva egyszerre, mindegyiket a saját lapján, így több fájlon is dolgozhat, és szabadon válthat közöttük. Nem kell megnyitnia egy fájlt a kezdéshez – kezdjen el gépelni a már ott lévő üres dokumentumba, vagy használja az eszköztár fájl gombjait:

• Új dokumentum — megnyit egy rövid menüt (Új létrehozása), amely felsorolja a nyolc jelölőnyelvet; válasszon egyet, hogy új, üres dokumentumot kezdjen abban a jelölőnyelvben, egy új lapon.
• Markdown fájl megnyitása — tallózás meglévő fájl megnyitásához. A választó elfogadja mind a nyolc jelölőformátumot, és az Markzen a fájl kiterjesztéséből választja ki a megfelelőt. Abban a mappában nyílik meg, ahonnan utoljára dokumentumot vett, ezt a program megjegyzi a munkamenetek között, így nem kell minden alkalommal elölről kezdenie.
• Mentés — az aktív dokumentumot visszaírja a fájljába. Az a dokumentum, amelyet soha nem mentettek el, a Mentés másként funkcióra esik, így először nevet adhat neki.
• Mentés másként — az aktív dokumentumot új fájlba menti, az eredetit érintetlenül hagyva.

A fájlkezelőből kihúzhat egy fájlt, és ráejtheti az ablakra a megnyitáshoz.

Minden megnyitott dokumentum egy lap az ablak tetején. A nem mentett lapot pont jelöli, a nem Markdown jelölésű lapon pedig egy kis formátumjelvény (például adoc) található. A lapon lévő × bezárja azt – és a nem mentett változtatásokkal rendelkező dokumentum bezárása soha nem dobja el azokat csendben: egy beépített sáv jelenik meg a lapon, így először Mentés vagy Elvetés gombot használhatja.

Amíg egy dokumentum nyitva van, az Markzen figyeli a fájlját a lemezen. Ha a fájl egy másik programban megváltozik, és Önnek nincsenek saját, nem mentett szerkesztései, az Markzen automatikusan behúzza az új verziót; ha vannak nem mentett szerkesztései, először megkérdezi – egy beépített Újratöltés sáv segítségével döntheti el, hogy a lemezen lévő verziót veszi-e át, vagy megtartja a sajátját.

Élő előnézet

A jobb oldali panel a dokumentum stílusos HTML-ként renderelt változata, amely gépelés közben élőben frissül. A linkek működnek, a táblázatok igazodnak, a kód monospaced blokkban jelenik meg, a feladatlisták jelölőnégyzeteket kapnak, és minden renderelési kiterjesztés blokk (lásd alább) a helyén rajzolja ki az ábráját. Az előnézet hű képet ad arról, hogy hogyan fog kinézni egy HTML vagy PDF export.

Ha egy Markdown dokumentum YAML front-matter blokkal nyílik meg – az --- key: value --- szakasz, amelyet az olyan eszközök, mint a Jekyll, Hugo és Obsidian a legtetejére helyeznek –, az Markzen rendezett metaadatkártyaként rendereli a dokumentum felett, ahelyett, hogy a záró --- egy eltévedt címmé válna.

Elrendezési módok

Három eszköztár gombcsoportja határozza meg, mit mutat az ablak:

• Osztott nézet — szerkesztő és előnézet egymás mellett. Húzza az elválasztót, hogy módosítsa, mennyi helyet kap mindegyik.
• Szerkesztő megjelenítése — csak a szerkesztő, kitöltve az ablakot a zavaró tényezőktől mentes íráshoz.
• Előnézet megjelenítése — csak az előnézet, egy tiszta, teljes szélességű olvasó.

Tartalomjegyzék

A Tartalomjegyzék gomb megnyit egy panelt, amely automatikusan épül fel a dokumentum minden címsorából (#, ##, ###, …). Kattintson bármelyik bejegyzésre, hogy az előnézetet az adott szakaszhoz görgesse. Minden olyan címsor, amely alatt alfejezetek vannak, egy nyilat mutat: kattintson rá a szakasz Összecsukás összecsukásához és a beágyazott címsorok elrejtéséhez, vagy a Kibontás kibontásához, hogy visszahozza őket – így egy hosszú vázlatot csak azokra a részekre hajthatja össze, amelyeken éppen dolgozik. A panel fejlécében található kis 2 / 3 / 4 gombok korlátozzák a vázlatot az adott címsor mélységre – hasznos egy hosszú dokumentumban, ha csak a felső szinteket szeretné látni –, és az aktívra való újbóli kattintás minden szintet visszahoz. A panel a bal szélének húzásával átméretezhető, és összecsukható az olvasási hely felszabadításához. Ez csak az alkalmazáson belüli navigációs segédlet – soha nem jelenik meg exportáláskor.

Saját vázlat megadása. Ha a címsorok nem a kívánt vázlatot adják, egy dokumentum hordozhatja a sajátját. Egy markzen címkével ellátott keretes blokk, amelynek első sora toc, felváltja a generált panelt az alatta írt listával:

`markdown

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

A behúzás határozza meg a szintet, és minden bejegyzés egy olyan horgonyra mutat, amelynek léteznie kell magában a dokumentumban – egy címsor, amelynek explicit id-t adott, vagy egy egyszerű <a id="intro"></a>. Maga a blokk semmit sem rajzol: ez egy metaadat, amelyet a panel olvas.

Táblázatok és táblázatkezelők

A táblázatok tisztán mozognak az Markzen és bármely táblázatkezelő között. Illesszen be tabulátorral elválasztott szöveget – Excelből, Google Táblázatokból, Wordből vagy webes táblázatból másolva – a szerkesztőbe, és az Markzen megfelelő táblázattá alakítja a dokumentum saját jelölőnyelvén, ahelyett, hogy tabulátor karakterek falát illesztené be. A beillesztő olvasó idézetérzékeny (helyesen kezeli azokat a cellákat, amelyek maguk is tartalmaznak tabulátorokat, sortöréseket vagy idézőjeleket), és csak akkor aktiválódik, ha a vágólap legalább két oszlopból álló tiszta téglalap alakú rácsot tartalmaz; minden más egyszerű szövegként illesztődik be.

Táblázatot a nulláról is elkezdhet. Az eszköztár Táblázat beszúrása gombja egy kis rácsot nyit meg – húzza át rajta, hogy kiválassza, hány sort és oszlopot szeretne, és az Markzen egy üres táblázatot ír a dokumentum saját jelölőnyelvén, készen a gépelésre. Az első sor a fejléc sor.

A fordítottja is működik. Vigye az egeret bármelyik megjelenített táblázat fölé az előnézetben, és egy másolás gomb jelenik meg a sarkában: ez visszamásolja a táblázatot tabulátorral elválasztott szövegként, amely közvetlenül beilleszthető egy táblázatkezelő cellájába vagy egy Word dokumentumba. Ezek a másolás gombok csak az előnézet kényelmét szolgálják – minden exportálásból és konverzióból eltávolításra kerülnek, így egy megosztott fájl csak a tiszta táblázatot tartalmazza.

Megjelenítési kiterjesztések

Az Markzen a szabványos jelölést kiterjeszti a keretes kódblokkokon keresztül. A nyitó hármas backtick utáni nyelvi címke dönti el, hogyan jelenik meg a blokk: az Markzen által kiterjesztésként felismert címke élő ábrát rajzol a kód megjelenítése helyett.

Minden ábrafajtát a saját megjelenítő motorja rajzolja, és az Markzen akkor tölt be egy motort, amikor egy dokumentum ténylegesen kéri azt, ahelyett, hogy az összeset betöltené indításkor – ezért indul el az alkalmazás szinte azonnal, és ezért tarthat egy pillanatig az első adott típusú diagram megjelenése, míg minden későbbi azonnali.

Például ez a forrás:

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

élő folyamatábrát jelenít meg, nem kódlistát – és PDF és HTML exportáláskor is folyamatábra marad.

Diagramok, grafikonok, matematika, zenei jelölések, sakk- és Go-táblák, QR-kódok és még sok más be van építve – a Kompatibilitás felsorolja mindegyiket a címkéjével együtt.

Minden kiterjesztésnek megvan a saját nyelvi címkéje (mermaid, chartjs, katex, abc, chess, …). Annyit keverhet belőlük, amennyit csak akar, közönséges prózával egyetlen dokumentumban – mind együtt jelennek meg. Az, hogy egy ábra továbbra is ábra marad-e, miután a dokumentum elhagyja az Markzen-t, attól függ, hová küldi – lásd az alábbi Konvertálás és exportálás részt.

Képletek egy mondaton belül

Egy matematikai képlet lehet önálló blokk – egy katex vagy asciimath blokk, amely önállóan áll és középre igazítva, mint egy egyenlet egy tankönyvben. Ez mind a nyolc jelölőnyelvben működik.

Egy képlet egy mondaton belül is elhelyezkedhet, így "a terület pi r négyzet" egy sor prózának olvasható, valódi szimbólumokkal. Ez attól függ, hogy a jelölőnyelv rendelkezik-e erre vonatkozó jelöléssel, és mindegyik másképp írja le – a nyelvenkénti jelölés a Kompatibilitás részben található.

A Textile és a BBCode a két kivétel, és ez inkább ezen nyelvek korlátja, mint az Markzen-é: egyik sem határozott meg módot a matematika írására. Egy Textile vagy BBCode dokumentumban egy képletnek ezért önálló blokknak kell lennie. Semmi sem vész el – a képlet megjelenik, és túléli az exportálást – egyszerűen nem szőhető bele egy prózasorba.

Ábra elhelyezése és méretezése

Vigye az egeret egy renderelt ábra fölé az előnézetben, és megjelenik mellette egy kis panel: igazítás gombok (balra, középre, jobbra) és – az átméretezhető ábrák esetében – szélesség és magasság mezők pixelben. A remove style block törli őket.

Ez a választás nem marad láthatatlanul: a panel beírja a dokumentumba, egy rövid markzen címkével ellátott blokkként, közvetlenül az ábra elé, amelyre vonatkozik.

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

Így az elrendezés a fájllal együtt utazik – része annak, amit ment, átad és exportál, bármely gépen. A blokkot kézzel is megírhatja: egy direktíva soronként, align (left, center vagy right), width és height pixelben, mindig az alatta lévő blokkra vonatkozóan.

Egy dokumentum stílusozása CSS-sel

Egy Markdown dokumentum saját stíluslapot is tartalmazhat, egy style címkével ellátott keretes blokkban:

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

A szabályok az adott dokumentum előnézetére, valamint PDF és HTML exportjaira vonatkoznak, az éppen aktív stílussablonon felül – ez egy módja annak, hogy egy dokumentumnak saját megjelenést adjon anélkül, hogy az összes többi beállítását megváltoztatná. Csak közönséges szelektorok: az at-szabályok, mint például az @media és az @keyframes nem támogatottak, és a blokk csak Markdown dokumentumokban működik.

Konvertálás és exportálás

Az eszköztár Konvertálás menüje az a hely, ahol egy elkészült dokumentum elhagyja az Markzen alkalmazást. Két különálló dolgot végez.

Konvertálás másik jelölőnyelvre. A Könnyű jelölés alatt az aktuális dokumentum átírható a másik hét jelölőnyelv bármelyikére – AsciiDoc, BBCode, Djot, MediaWiki, Org, reStructuredText vagy Textile. Hasznos, ha egy wiki MediaWikit, egy fórum BBCode-ot, egy kiadó AsciiDoc-ot szeretne, vagy jegyzeteket mozgat ökoszisztémák között. Mind a nyolc egyszer jelenik meg a menüben, mint jelölőnyelv: egy innen MediaWiki formátumban mentett dokumentum ugyanaz a fájl, amit máshol is kapna.

Exportálás kész formátumba. A dokumentumot átadja a mellékelt konverternek, amely több mint húsz dokumentumformátumot állít elő, rendeltetésük szerint csoportosítva:

Kategória	Formátumok
E-könyvek	EPUB 3, FictionBook2
Szövegszerkesztő	Microsoft Word (.docx), OpenDocument (.odt), Rich Text Format (.rtf)
Prezentáció	Microsoft PowerPoint (.pptx), reveal.js (.html)
Szedés	InDesign ICML, LaTeX (.tex), Typst (.typ)
XML	DocBook, JATS, OpenDocument XML, TEI Simple
Jegyzetfüzet	Jupyter Notebook (.ipynb)
Vázlat	OPML (.opml)

A konverter az Markzen belsejében található – nincs szükség további letöltésre vagy konfigurálásra. Ezek mellett három gyors kimenet található az eszköztáron: a Mentés PDF-ként és a Mentés HTML-ként pontosan úgy exportálja a renderelt dokumentumot, ahogyan az előnézetben látható (stílussablon, betűtípusok és kiterjesztési ábrák is), a Nyomtatás pedig nyomtatóra küldi. A kód betűtípusa az exportált fájl belsejében utazik, így egy kódblokk vagy egy ASCII diagram úgy jelenik meg az olvasó gépén, ahogyan Ön látta, függetlenül attól, hogy telepítve van-e náluk az adott betűtípus.

Mi utazik, és mi nem. Egy renderelési kiterjesztés ábra csak ott marad ábra, ahol a célformátum képes képet tárolni, így egy dokumentum két úton hagyja el az Markzen alkalmazást:

• Ahogy a dokumentumot látja – a fent leírt három eszköztár kimenet (PDF, HTML, nyomtatás) és a fenti táblázatban szereplő formátumok közül öt: EPUB 3, Microsoft Word (.docx), OpenDocument (.odt), Microsoft PowerPoint (.pptx) és Rich Text Format (.rtf). A diagramok, képletek és kották képként kerülnek kiírásra és érintetlenül érkeznek meg.
• A dokumentum forrásszövegeként – minden más cél, és minden konverzió másik jelölőnyelvre. A próza, a címsorok, a listák, a táblázatok és a linkek mind konvertálódnak; egy mermaid vagy katex blokk közönséges kódblokként érkezik, amely a beírt forrást tartalmazza, mert ezek a formátumok nem rendelkeznek ábrával, amelyet az Markzen átadhatna nekik.

Tehát a diagramokra épülő dokumentumokat a legjobb PDF, HTML, EPUB, Word, OpenDocument, PowerPoint vagy RTF formátumban átadni. A LaTeX, Typst, reveal.js és a többi továbbra is a teljes dokumentumot adja – az egyes ábrák forrása a helyén marad, készen az adott ökoszisztéma saját eszközei számára.

Exportálás parancssorból

Az Markzen ablak megnyitása nélkül is működik. Adjon át az Markzen futtatható fájlnak egy forrásfájlt és egy -o kapcsolót egy kimeneti útvonallal, és az rendereli a dokumentumot, majd egyenesen a lemezre írja az exportált fájlt:

markzen.exe report.md -o report.pdf

A forrás bármelyik lehet a nyolc jelölőnyelv formátum közül, amit az Markzen olvas; a kimenet PDF vagy HTML fájl, amelyet a kimeneti név kiterjesztése választ ki. Az exportálás ugyanazon a renderelési folyamaton megy keresztül, mint maga az alkalmazás, így a diagramok, képletek és minden más bővítményblokk élő ábrákként jelennek meg. Az exportálások az alapértelmezett stílussablont és betűtípusokat használják – a parancssor saját tiszta profiljában fut, elkülönítve az alkalmazástól, ami azt is jelenti, hogy akkor is jól működik, ha az Markzen már nyitva van.

Több dokumentum is exportálható egyetlen hívással – adjon meg tetszőleges számú source -o output párt, és egyetlen indítás mindet rendereli, a fájlonkénti indítás költségének töredékéért:

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

Betűtípusok és megjelenés

Az Markzen úgy készült, hogy a dokumentumok inkább szedett, mintsem általános megjelenésűek legyenek. Az ehhez szükséges vezérlők a eszköztáron találhatók a Stílus és betűtípusok gomb mögött, így olvasás közben is beállíthatja őket; a téma és az interfész nyelve a Beállítások → Megjelenítés menüpontban található.

Stílussablon

A Stílus öt előnézeti stílust kínál: Standard, GitHub, Könyv, Modern, Minimális. A kiválasztott sablon az a stílus is, amelyet a PDF és HTML exportokra alkalmaznak, így ez dönti el, hogyan olvasható egy megosztott dokumentum – válasszon Könyv vagy Modern stílust, ha átadja valakinek, Minimális stílust pedig a zavartalan olvasáshoz. A sablon csak az előnézetet stílusozza, soha nem a szerkesztőt.

Betűtípusok

Ugyanezen a panelen három választó állít be külön betűtípust minden szövegtípushoz – Címsor, Törzsszöveg és Kód –, ami miatt egy Markzen dokumentum szedettnek érződik:

• Címsor — Oswald, Playfair Display, Merriweather, Raleway, Montserrat, Lora, Libre Baskerville, Bebas Neue, Abril Fatface, Cinzel.
• Szövegtörzs — Inter, Roboto, Georgia, Lato, Source Serif 4, Nunito, PT Serif, Crimson Text, Libre Franklin, Open Sans.
• Kód — JetBrains Mono, Source Code Pro, Cascadia Mono, Fira Mono.

A kód betűtípusokat a megjelenésen túl egy tulajdonság miatt választották: mindegyik rajzolja a dobozrajzoló karaktereket (│ ├ └ ─), amelyekből a fa listák és ASCII diagramok készülnek, így egy kódtömbbe beillesztett könyvtárfa megtartja alakját, ahelyett, hogy résekre törne. Ezek a ligatúra nélküli változatok is – egy ligatúrákkal rendelkező betűtípus az != jelet egyetlen ≠ jelként rajzolja újra, ami kellemes egy kódszerkesztőben, és helytelen egy olyan dokumentumban, amely azt hivatott megmutatni, amit a fájl valójában mond. A JetBrains Mono és a Source Code Pro az Markzen-ben található, így olyan gépen is működnek, amely soha nem látta őket, és semmilyen kapcsolattal sem rendelkezik.

Szövegméret

Az eszköztár Betűméret növelése és Betűméret csökkentése gombjai változtatják a szövegméretet.

Téma és nyelv

A Beállítások → Megjelenítés menüpontban:

• Téma — Világos vagy Sötét. Alapértelmezett: Világos.
• Nyelv — Az Markzen saját felülete több mint ötven nyelvre van lefordítva, beleértve a jobbról balra író nyelveket (arab, héber) és a CJK (kínai, japán, koreai) nyelveket is.

Kompatibilitás

A referenciatáblázatok: mit támogat az egyes jelölőnyelvek, és milyen élő ábrákat rajzolhat az Markzen. Itt minden arról szól, hogy mi hol működik – a magyarázatok a fenti szakaszokban találhatók.

Mit tud az egyes jelölőnyelvek

Jelölőnyelv	Fájlok megnyitása, melyek erre végződnek	Élő ábrák	Tartalom panel	Képlet egy mondatban	Nem fejezhető ki
Markdown	.md, .markdown	mind	igen	$…$	szöveg igazítása
AsciiDoc	.adoc, .asciidoc, .asc	mind, kivéve style	igen	csak blokk	áthúzás
reStructuredText	.rst, .rest	mind, kivéve style	igen	$…$	áthúzás
Org	.org	mind, kivéve style	igen	$…$	bal és jobb igazítás
Textile	.textile	mind, kivéve style	igen	csak blokk	—
Djot	.dj	mind, kivéve style	igen	$`…`	—
MediaWiki	.wiki, .mediawiki, .wikitext	mind, kivéve style	igen	<math>	inline kód, áthúzás, blokk idézet, szöveg igazítás
BBCode	.bbcode, .bb	mind, kivéve style	igen	csak blokk	—

Élő ábrák — a style blokk az egyetlen kivétel: CSS-t alkalmaz magára a dokumentumra, amit csak a Markdown támogat. Minden más típusú ábra minden nyelven működik. Egy BBCode dokumentumban a blokk [code=mermaid]…[/code] formában van írva, nem pedig backtickekkel; MediaWikiben <syntaxhighlight lang="mermaid">…</syntaxhighlight>.

Nem fejezhető ki — ezek maguknak a jelölőnyelveknek a korlátai, nem az Markzen-é: ahol egy nyelvnek nincs jelölése valamire, ott az Markzen nem kínál hozzá gombot, ahelyett, hogy egy olyan privát dialektust írna, amit csak ő tudna visszaolvasni. Lásd a Képletek egy mondaton belül részt a matematikai sorhoz.

Mindenféle ábra

Írja be a címkét a nyitó három backtick után — ```mermaid — és a blokk ábrává válik.

Kategória	Ábra	Blokkcímke	Megjegyzések
Diagramok	Mermaid	mermaid	folyamatábrák, szekvencia, osztály, Gantt, ER, állapot
	Graphviz	graphviz	a DOT nyelv
	Cytoscape	cytoscape	hálózati gráfok; pásztázás és nagyítás az előnézetben
	Markmap	markmap	gondolattérkép pontozott vázlatból; kattintással összecsukható
	Timeline	timeline	függőleges esemény idővonal
Szoftver diagramok	Nomnoml	nomnoml	UML
	PlantUML	plantuml	UML — az egyetlen ábra, ami internetkapcsolatot igényel
	DBML	dbml	adatbázis séma diagramok
Diagramok	Chart.js	chartjs	oszlop, vonal, kör, radar
	Vega-Lite	vega-lite	deklaratív diagramok JSON-ból
	ECharts	echarts	nagy interaktív diagramok
IT fejlesztés	Pszeudokód	pseudocode	típusos algoritmusok
	Tabulator	tabulator	rendezhető interaktív táblázat
	Bytefield	bytefield	bit és bájt mező elrendezések
	QR Code	qrcode
	Railroad	railroad	szintaxis diagramok
	WaveDrom	wavedrom	digitális időzítési diagramok
Matematika	KaTeX	katex	$…$ egy mondatban is — lásd a fenti táblázatot
	AsciiMath	asciimath	egyszerű szöveges matematikai jelölés
Gráfok	function-plot	fnplot	függvénygörbe ábrázolása
	JSXGraph	jsxgraph	interaktív geometria
	Plotly	plotly	tudományos és 3D diagramok
Tudományok	SMILES	smiles	kémiai szerkezeti diagramok
Zene	ABC Notation	abc	kottázás egyszerű szövegből
	VexFlow	vexflow	gravírozott kottavonalak
	VexChords	vexchords	gitár akkord diagramok
	ChordPro	chordpro	akkordok a dalszöveg felett
	MusicXML	musicxml	teljes kották
Játékok	Chess	chess	egy tábla FEN pozícióból
	Go Board	goboard	9×9, 13×13 és 19×19
Dokumentum	Markzen	markzen	láthatatlan: elhelyezi és méretezi az alatta lévő ábrát, vagy felülírja a tartalompanelt
	Style	style	láthatatlan: CSS ehhez a dokumentumhoz — csak Markdown

Fájltársítások

Windowson a telepítő regisztrálhatja az Markzen alkalmazást minden általa olvasott jelölőnyelv-fájltípus kezelőjeként – mind a tizenöt kiterjesztést, amelyek a Kompatibilitás részben szerepelnek, mind a nyolc nyelven. A regisztrációt követően az Explorerben egy ilyen fájlra duplán kattintva közvetlenül az Markzen alkalmazásban nyílik meg, és ha több szerkesztő is telepítve van, akkor is kiválaszthatja az Markzen alkalmazást a „Társítás…” menüponttal.

Billentyűparancsok

Billentyű	Művelet
Ctrl+S	Mentés
Ctrl+Shift+S	Mentés másként
Ctrl+ + / Ctrl+ -	Szövegméret növelése / csökkentése

A szabványos szerkesztőparancsok – keresés, csere, másolás, beillesztés, visszavonás, ismétlés – és a formázási eszköztár parancsai (félkövér Ctrl+B, dőlt Ctrl+I, címsor Ctrl+H, hivatkozás Ctrl+K és még sok más) működnek a szerkesztőpanelen. Formázási parancs csak ott létezik, ahol az aktuális jelölés tartalmazza a szerkezetet – a Ctrl+D nem csinál semmit egy AsciiDoc dokumentumban, amelynek nincs saját áthúzása (lásd A szerkesztő).

Tippek

• Rejtse el a szerkesztőt az olvasáshoz. Az előnézetet mutató egyetlen nézet tiszta olvasóvá alakítja az Markzen-t, és az öt stílussablon segítségével beállíthatja a megjelenését.
• Egy dokumentum, mindenféle tartalom. Egy Mermaid folyamatábra, egy KaTeX egyenlet és egy kottajegyzet is elhelyezkedhet az egyszerű próza mellett – mind együtt renderelődnek, és mind túlélik a PDF és HTML exportálást.
• A stílussablon az exportált megjelenés. Bármelyik sablont is választja, az a PDF és HTML kimenetbe beépített stílus lesz, ezért exportálás előtt állítsa be.
• Írjon a kedvenc jelölőnyelvén, szállítson a szükséges formátumban. Készítsen vázlatot Markdownban (vagy a nyolc közül bármelyikben), majd használja a Konvertálás menüt egy Word fájlhoz, egy diavetítéshez, egy e-könyvhöz vagy egy LaTeX forráshoz – nincs szükség külön eszközökre.