Nápověda
Co je Markzen?
Markzen je desktopový editor pro odlehčené značkovací jazyky – Markdown a šest dalších – s živým, plně stylovaným náhledem. Na levé straně píšete prostý text označený jednoduchou interpunkcí a Markzen jej během psaní vykresluje jako formátovaný HTML na pravé straně.
Co jej odlišuje od běžného editoru Markdown, je obousměrný převod. Markzen čte osm značkovacích jazyků, vykresluje 30 živých rozšíření (diagramy, grafy, matematické vzorce, notové zápisy, šachovnice, QR kódy) uvnitř dokumentu a exportuje do více než dvaceti formátů – e-knihy, Word, PowerPoint, LaTeX, Jupyter notebooky a další. Napište jednou, výsledek předejte téměř v čemkoli. Převodník je vestavěný, takže není třeba instalovat žádné externí nástroje.
Můžete otevřít existující soubor nebo prostě začít psát – není nutné nejprve otevřít soubor.
Editor
Levý panel je plnohodnotný editor kódu CodeMirror, nikoli obyčejné textové pole: má zvýrazňování syntaxe pro značky, které píšete, panel nástrojů pro formátování (tučné písmo, kurzíva, nadpisy, seznamy a další, plus vyhrazená tlačítka pro vkládání odkazů a obrázků – viz Odkazy a obrázky – a pro vkládání tabulky – viz Tabulky a tabulkové procesory) a vyhledávání a nahrazování. Standardní editační zkratky – kopírovat, vložit, vrátit zpět, opakovat – fungují tak, jak byste očekávali.
Píšete v jednom z osmi lehkých značkovacích jazyků. Jedná se o formáty prostého textu, které vyjadřují strukturu pomocí interpunkce (# pro nadpis, * pro zvýraznění) namísto skrytého stylu, takže dokument zůstává čitelný jako text a je přátelský k rozdílům ve správě verzí. Markzen čte všech osm a rozhoduje, který z nich soubor je, podle jeho přípony – formát nikdy nevybíráte ručně. Kompatibilita uvádí, které přípony otevírají který jazyk.
Každý jazyk má své vlastní konvence a svůj vlastní existující ekosystém dokumentů; Markzen vykresluje každý ve svém vlastním dialektu, spíše než aby nejprve vše převáděl na Markdown. BBCode je ten, který nemá žádný jednotný standard – každé fórum si vymyslelo svou vlastní variantu – takže Markzen jej čte velkoryse, přijímá běžné pravopisy vedle sebe ([list] nebo [ul], [h1] nebo [heading=1]) a jakoukoli značku, kterou nerozpozná, ponechává viditelnou jako prostý text, namísto aby ji polykal. Chcete-li změnit typ značek, ve kterých je dokument napsán, použijte nabídku Převést do na panelu nástrojů (viz Převést a exportovat níže).
Ne každý jazyk může vyjádřit vše. Panel nástrojů pro formátování obsahuje stejná tlačítka v každém dokumentu, ale Markzen vždy píše pouze značky, které definuje samotný jazyk – nikdy nevymýšlí soukromý dialekt, aby zakryl mezeru. Tlačítko, pro které aktuální jazyk nemá žádnou notaci, je zašedlé. Tučné písmo, kurzíva, nadpisy, seznamy, bloky kódu, odkazy, obrázky, pravidla a tabulky jsou k dispozici ve všech osmi; hrstka mezer je uvedena v Kompatibilita. Markdown je ten, který lidi překvapuje: nemá standardní způsob, jak zarovnat odstavec na střed, takže Markzen tam nenabízí žádná tlačítka pro zarovnání, spíše než aby psal něco, co by ctili jen někteří čtenáři.
Velikost textu se nastavuje pomocí tlačítek Zvětšit text a Zmenšit text na panelu nástrojů. Panel editoru lze také zcela skrýt – když je, Markzen se stane čistým čtenářem (viz Živý náhled).
Odkazy a obrázky
Formátovací panel nástrojů má dvě vyhrazená tlačítka pro vložení odkazu nebo obrázku do dokumentu, a každé otevře malé vyskakovací okno přímo u kurzoru. Odkaz (Ctrl+K) – nebo stiskněte Ctrl+K – vloží hypertextový odkaz: zadejte text odkazu a jeho adresu, a Markzen pro něj napíše správné značení. Obrázek vloží obrázek stejným způsobem, s několika dalšími možnostmi, které jsou popsány níže.
Oba jsou napsány v značení, které používá aktuální dokument – odkaz vložený do souboru AsciiDoc vyjde jako AsciiDoc, do souboru Org jako Org a tak dále ve všech osmi jazycích.
Začínáme s adresou, kterou již máte. Vložte webovou adresu do dokumentu, vyberte ji a stiskněte Ctrl+K: Markzen vidí, že výběr je adresa spíše než slova, vloží ji do pole adresy vyskakovacího okna a ponechá kurzor v prázdném textovém poli, čekající na to, co by měl odkaz říkat. Bez toho by se vybraná adresa stala viditelným textem odkazu – odkaz, který se čte jako holá URL. Absolutní cesty k souborům se také počítají jako adresy, na Windows i jinde, takže stejná zkratka změní vloženou cestu na odkaz na tento soubor.
Úprava existujícího odkazu nebo obrázku. Umístěte kurzor kamkoli na existující odkaz nebo obrázek a znovu otevřete vyskakovací okno (tlačítko, nebo Ctrl+K): Markzen rozpozná konstrukci, načte její aktuální text a adresu do vyskakovacího okna a nahradí celou věc, když potvrdíte – takže ji upravíte na místě namísto náhodného vnoření nového odkazu do starého.
Pro obrázek vyskakovací okno také nabízí tlačítko Vyhledat obrázek pro výběr souboru z disku namísto zadávání cesty – otevře se ve složce, ze které jste naposledy vzali obrázek, uchovávané odděleně od té, ze které pocházejí vaše dokumenty – a jednu důležitou volbu: zda je obrázek vložený nebo propojený.
Vložené nebo propojené obrázky
Když vložíte obrázek, Markzen jej může uložit do dokumentu dvěma způsoby:
- Propojeno – dokument pouze ukazuje na obrázek, pomocí cesty k souboru nebo webové adresy. Soubor dokumentu zůstává malý, ale obrázek s ním musí cestovat (nebo zůstat dostupný na své URL), jinak se jinde nezobrazí. Toto je výchozí nastavení.
- Vloženo – skutečné bajty obrázku jsou zapsány do dokumentu jako text (blok base64
data:), takže soubor je zcela soběstačný: jeden soubor nese vše, aniž by se cokoli ztratilo. Kompromisem je velikost – dokument se zvětší o váhu obrázku a vložený obrázek nemůže používat relativní cestu.
Vyberte Vložené, když chcete jeden přenosný soubor k předání; vyberte Propojené, když uchováváte obrázky vedle dokumentu a chcete, aby soubor zůstal malý.
Pro propojený obrázek se objeví ještě jedna možnost: Relativní cesta. Když se obrázek nachází ve vlastní složce dokumentu (nebo podsložce), zaškrtnutím této možnosti se odkaz zapíše jako krátká relativní cesta namísto plné absolutní, takže odkaz funguje i po přesunutí dokumentu a jeho obrázků dohromady. Nabízí se pouze tehdy, když je obrázek uvnitř složky dokumentu – jinak není žádná relativní cesta k zápisu.
Vložené obrázky zůstávají v editoru úhledné. Obrázek vložený v base64 je dlouhá zeď textu, která by jinak pohřbila řádky kolem něj, takže Markzen každý z nich složí do malého čipu zobrazujícího jeho typ a velikost (například 🖼 webp · 38 KB). Čip je pouze pro zobrazení – podkladový text je nedotčen, takže ukládání, kopírování nebo vyjímání vždy přenáší celý obrázek a kurzor přeskočí čip jako jednu jednotku.
Soubory, záložky a ukládání
Markzen udržuje otevřených tolik dokumentů, kolik chcete, každý ve své vlastní záložce, takže můžete pracovat s několika soubory a volně mezi nimi přepínat. Pro začátek nemusíte otevírat soubor – začněte psát do prázdného dokumentu, který je již k dispozici, nebo použijte tlačítka souborů na panelu nástrojů:
- Nový dokument – otevře krátké menu (Vytvořit nový) s osmi značkovacími jazyky; vyberte jeden pro zahájení nového, prázdného dokumentu napsaného v tomto značkovacím jazyce, v nové záložce.
- Otevřít soubor Markdown – prohledávejte existující soubor a otevřete jej. Výběr akceptuje všech osm formátů značkování a Markzen vybere správný z přípony souboru. Otevře se ve složce, ze které jste naposledy vzali dokument, zapamatované mezi relacemi, takže nemusíte pokaždé začínat od nuly.
- Uložit – zapíše aktivní dokument zpět do jeho souboru. Dokument, který nikdy nebyl uložen, se přesune na Uložit jako, abyste jej mohli nejprve pojmenovat.
- Uložit jako – uloží aktivní dokument do nového souboru, přičemž původní zůstane nedotčen.
Můžete také přetáhnout soubor ze správce souborů a pustit jej do okna pro jeho otevření.
Každý otevřený dokument je záložka v horní části okna. Neuložená záložka je označena tečkou a záložka, jejíž značkování není Markdown, nese malý odznak formátu (například adoc). × na záložce ji zavře – a zavření dokumentu s neuloženými změnami je nikdy tiše nezahodí: na záložce se objeví vložený pruh, takže můžete nejprve Uložit nebo Zahodit.
Zatímco je dokument otevřen, Markzen sleduje jeho soubor na disku. Pokud se soubor změní v jiném programu a nemáte žádné vlastní neuložené úpravy, Markzen automaticky načte novou verzi; pokud máte neuložené úpravy, nejprve se zeptá – vložený pruh Znovu načíst vám umožní rozhodnout, zda přijmout verzi na disku nebo si ponechat vlastní.
Živý náhled
Pravý panel je dokument vykreslený jako stylovaný HTML, aktualizovaný živě, jak píšete. Odkazy fungují, tabulky se zarovnávají, kód je zobrazen v monospace bloku, seznamy úkolů dostávají zaškrtávací políčka a každý blok rozšíření pro vykreslování (viz níže) vykreslí svůj obrázek na místě. Náhled je věrným obrazem toho, jak bude vypadat export do HTML nebo PDF.
Pokud se dokument Markdown otevře s blokem YAML front-matter — sekcí --- key: value ---, kterou nástroje jako Jekyll, Hugo a Obsidian umisťují úplně nahoru — Markzen ji vykreslí jako úhlednou kartu metadat nad dokumentem, místo aby se závěrečné --- změnilo na zatoulaný nadpis.
Režimy rozložení
Skupina tří tlačítek na panelu nástrojů nastavuje, co okno zobrazuje:
- Rozdělené zobrazení — editor a náhled vedle sebe. Přetáhněte oddělovač pro změnu velikosti prostoru, který každý z nich dostane.
- Zobrazit editor — pouze editor, vyplňující okno pro psaní bez rušení.
- Zobrazit náhled — pouze náhled, čistá čtečka na celou šířku.
Obsah
Tlačítko Obsah otevře panel automaticky vytvořený ze všech nadpisů v dokumentu (#, ##, ###, …). Kliknutím na libovolnou položku se náhled posune na tuto sekci. Každý nadpis s podnadpisy pod ním zobrazuje šipku: kliknutím na ni Sbalit tuto sekci sbalíte a skryjete její vnořené nadpisy, nebo Rozbalit je vrátíte zpět — takže můžete dlouhý přehled sbalit pouze na části, na kterých pracujete. Malá tlačítka 2 / 3 / 4 v záhlaví panelu omezují přehled na tuto hloubku nadpisů — užitečné v dlouhém dokumentu, když chcete vidět pouze nejvyšší úrovně — a opětovným kliknutím na aktivní tlačítko se vrátí všechny úrovně. Panel se mění velikostí přetažením jeho levého okraje a sbalí se, aby se uvolnil prostor pro čtení. Je to navigační pomůcka pouze uvnitř aplikace — nikdy se neobjeví v exportu.
Poskytnutí vlastního přehledu. Pokud nadpisy nejsou přehledem, který chcete, dokument může nést svůj vlastní. Ohraničený blok označený markzen, jehož první řádek je toc, nahradí vygenerovaný panel seznamem napsaným pod ním:
`markdown
```markzen
toc
- [Introduction](#intro)
- [Background](#background)
- [Results](#results)
```
Odsazení nastavuje úroveň a každá položka odkazuje na kotvu, která musí existovat v samotném dokumentu — nadpis, kterému jste dali explicitní id, nebo prostý <a id="intro"></a>. Samotný blok nic nekreslí: jsou to metadata, která panel čte.
Tabulky a tabulkové procesory
Tabulky se čistě přesouvají mezi Markzen a jakýmkoli tabulkovým procesorem. Vložte text oddělený tabulátory – zkopírovaný z Excelu, Google Sheets, Wordu nebo webové tabulky – do editoru a Markzen jej převede na správnou tabulku napsanou ve vlastním značkovacím jazyce dokumentu, namísto vložení zdi tabulátorů. Čtečka vkládání je citlivá na uvozovky (správně zpracovává buňky, které samy obsahují tabulátory, zalomení řádků nebo uvozovky) a spustí se pouze tehdy, když schránka obsahuje čistou obdélníkovou mřížku o minimálně dvou sloupcích; cokoli jiného se vloží jako běžný text.
Tabulku můžete také začít od začátku. Tlačítko Vložit tabulku na panelu nástrojů otevře malou mřížku – přejeďte přes ni a vyberte, kolik řádků a sloupců chcete, a Markzen napíše prázdnou tabulku této velikosti ve vlastním značkovacím jazyce dokumentu, připravenou k psaní. První řádek je záhlaví.
Funguje to i naopak. Přejeďte myší nad jakoukoli vykreslenou tabulkou v náhledu a v jejím rohu se objeví tlačítko pro kopírování: zkopíruje tabulku zpět jako text oddělený tabulátory, který se přímo vloží do buňky tabulkového procesoru nebo dokumentu Word. Tato tlačítka pro kopírování jsou pouze pro pohodlí náhledu – jsou odstraněna z každého exportu a konverze, takže sdílený soubor obsahuje pouze čistou tabulku.
Rozšíření vykreslování
Markzen rozšiřuje standardní značení pomocí ohraničených bloků kódu. Jazyková značka hned za úvodními trojitými zpětnými apostrofy rozhoduje o tom, jak se blok vykreslí: značka, kterou Markzen rozpozná jako rozšíření, vykreslí živý obrázek namísto zobrazení kódu.
Každý typ obrázku je vykreslován vlastním vykreslovacím enginem a Markzen načte engine poprvé, když jej dokument skutečně vyžaduje, namísto načítání všech při spuštění – proto se aplikace spustí téměř okamžitě a proto se první diagram daného typu může objevit s malým zpožděním, zatímco každý další je okamžitý.
Například tento zdroj:
```mermaid
graph LR
A --> B --> C
```
se vykreslí jako živý vývojový diagram, nikoli jako výpis kódu – a zůstane vývojovým diagramem i v exportech do PDF a HTML.
Diagramy, grafy, matematika, notace, šachové a Go desky, QR kódy a další jsou vestavěné – Kompatibilita uvádí každý z nich s jeho značkou.
Každé rozšíření má svou vlastní jazykovou značku (mermaid, chartjs, katex, abc, chess, …). Můžete jich kombinovat tolik, kolik chcete, s běžnou prózou v jednom dokumentu – všechny se vykreslí dohromady. Zda je obrázek stále obrázkem, jakmile dokument opustí Markzen, závisí na tom, kam jej odešlete – viz Převést a exportovat níže.
Vzorce uvnitř věty
Matematický vzorec může být blokem sám o sobě – blok katex nebo asciimath, stojící samostatně a vycentrovaný jako rovnice v učebnici. To funguje ve všech osmi značkovacích jazycích.
Vzorec může také sedět uvnitř věty, takže „plocha je pí r na druhou“ se čte jako jeden řádek prózy se skutečnými symboly. To závisí na tom, zda značkovací jazyk má pro to notaci, a každý ji píše jinak – notace pro každý jazyk je v Kompatibilita.
Textile a BBCode jsou dvě výjimky, a to je omezení těchto jazyků spíše než Markzen: ani jeden nikdy nedefinoval způsob, jak psát matematiku. V dokumentu Textile nebo BBCode proto musí být vzorec blokem sám o sobě. Nic se neztratí – vzorec se vykreslí a přežije export – jednoduše nemůže být vetkán do řádku prózy.
Umístění a velikost obrázku
Najeďte myší na vykreslený obrázek v náhledu a vedle něj se objeví malý panel: tlačítka zarovnání (vlevo, na střed, vpravo) a – pro typy obrázků, které lze měnit velikost – pole šířka a výška v pixelech. remove style block je znovu vymaže.
Tato volba není uchovávána někde neviditelně: panel ji zapíše do dokumentu jako krátký blok označený markzen, umístěný bezprostředně před obrázkem, na který se vztahuje.
```markzen
style
align center
width 480
```
Rozložení se tedy přenáší se souborem – je součástí toho, co ukládáte, předáváte a exportujete, na jakémkoli stroji. Blok můžete stejně tak napsat ručně: jedna direktiva na řádek, align (left, center nebo right), width a height v pixelech, vždy se vztahující k bloku přímo pod ním.
Stylování jednoho dokumentu pomocí CSS
Dokument Markdown může také nést svůj vlastní stylopis, v ohraničeném bloku označeném style:
```style
h2 { color: #b03030; border-bottom: 2px solid #b03030; }
blockquote { font-style: italic; }
```
Pravidla se vztahují na náhled tohoto dokumentu a na jeho exporty do PDF a HTML, navíc k jakékoli aktivní šabloně stylu – způsob, jak dát jednomu dokumentu vlastní vzhled, aniž byste měnili nastavení pro vše ostatní. Pouze běžné selektory: at-pravidla jako @media a @keyframes nejsou podporována a blok funguje pouze v dokumentech Markdown.
Převést a exportovat
Nabídka Převést do na panelu nástrojů je místo, kde hotový dokument opouští Markzen. Provádí dvě odlišné věci.
Převést na jiný značkovací jazyk. Pod Lehké značkování přepište otevřený dokument do kteréhokoli ze sedmi dalších značkovacích jazyků – AsciiDoc, BBCode, Djot, MediaWiki, Org, reStructuredText nebo Textile. Užitečné, když wiki chce MediaWiki, fórum chce BBCode, vydavatel chce AsciiDoc, nebo přesouváte poznámky mezi ekosystémy. Každý z osmi se v nabídce objeví jednou jako značkovací jazyk: dokument uložený jako MediaWiki odsud je stejný soubor, jaký byste získali kdekoli jinde.
Exportovat do hotového formátu. Předat dokument přibalenému převodníku, který vydává více než dvacet formátů dokumentů, seskupených podle toho, k čemu jsou určeny:
| Kategorie | Formáty |
|---|---|
| E-knihy | EPUB 3, FictionBook2 |
| Textový procesor | Microsoft Word (.docx), OpenDocument (.odt), Rich Text Format (.rtf) |
| Prezentace | Microsoft PowerPoint (.pptx), reveal.js (.html) |
| Sazba | InDesign ICML, LaTeX (.tex), Typst (.typ) |
| XML | DocBook, JATS, OpenDocument XML, TEI Simple |
| Zápisník | Jupyter Notebook (.ipynb) |
| Osnova | OPML (.opml) |
Převodník je součástí Markzen – nic navíc ke stažení nebo konfiguraci. Vedle nich jsou na panelu nástrojů tři rychlé výstupy: Uložit jako PDF a Uložit jako HTML exportují vykreslený dokument přesně tak, jak je zobrazen v náhledu (včetně šablony stylu, písem a rozšířených obrázků), a Tisk jej odešle na tiskárnu. Písmo kódu se přenáší uvnitř exportovaného souboru, takže blok kódu nebo ASCII diagram se na počítači čtenáře zobrazí tak, jak jste jej viděli, bez ohledu na to, zda má toto písmo nainstalované.
Co se přenáší a co ne. Obrázek rozšíření vykreslování zůstane obrázkem pouze tam, kde cílový formát může obsahovat obrázek, takže dokument opouští Markzen jednou ze dvou cest:
- Jako dokument, který vidíte – tři výstupy panelu nástrojů právě popsané (PDF, HTML, tisk) a pět formátů z výše uvedené tabulky: EPUB 3, Microsoft Word (
.docx), OpenDocument (.odt), Microsoft PowerPoint (.pptx) a Rich Text Format (.rtf). Diagramy, vzorce a noty jsou zapsány jako obrázky a dorazí neporušené. - Jako zdrojový text dokumentu – každý jiný cíl a každá konverze na jiný značkovací jazyk. Próza, nadpisy, seznamy, tabulky a odkazy se všechny převedou; blok
mermaidnebokatexdorazí jako obyčejný blok kódu obsahující zdroj, který jste zadali, protože tyto formáty nemají žádný obrázek, který by jim Markzen mohl předat.
Dokument postavený na diagramech je tedy nejlépe předat jako PDF, HTML, EPUB, Word, OpenDocument, PowerPoint nebo RTF. LaTeX, Typst, reveal.js a zbytek vám stále poskytnou celý dokument – se zdrojem každého obrázku ponechaným na místě, připraveným pro vlastní nástroje daného ekosystému.
Export z příkazového řádku
Markzen funguje i bez otevření okna. Spusťte spustitelný soubor Markzen se zdrojovým souborem a -o s výstupní cestou a dokument se vykreslí a export se zapíše přímo na disk:
markzen.exe report.md -o report.pdf
Zdroj může být libovolný z osmi formátů značení, které Markzen čte; výstupem je soubor PDF nebo HTML, zvolený podle přípony výstupního názvu. Export prochází stejným vykreslováním jako samotná aplikace, takže diagramy, vzorce a všechny ostatní bloky rozšíření se zobrazí jako živé obrázky. Exporty používají výchozí šablonu stylu a písma – příkazový řádek běží ve vlastním čistém profilu, odděleném od aplikace, což také znamená, že funguje dobře, i když je Markzen již otevřen.
V jednom volání lze exportovat několik dokumentů – zadejte libovolný počet párů source -o output a jediné spuštění je všechny vykreslí, za zlomek nákladů na spuštění jednou pro každý soubor:
markzen.exe a.md -o a.pdf b.adoc -o b.html c.rst -o c.pdf
Písma a vzhled
Markzen je navržena tak, aby dokument vypadal spíše jako vysázený než generický. Ovládací prvky pro to jsou společně na panelu nástrojů za tlačítkem Styl a písma, takže je můžete upravovat během čtení; téma a jazyk rozhraní jsou v Nastavení → Zobrazení.
Šablona stylu
Styl nabízí pět stylů náhledu: Standardní, GitHub, Kniha, Moderní, Minimální. Šablona, kterou si vyberete, je také styl aplikovaný na exporty PDF a HTML, takže rozhoduje o tom, jak se sdílený dokument čte – zvolte Kniha nebo Moderní pro něco, co budete předávat, Minimální pro čtení bez rušivých vlivů. Šablona stylizuje pouze náhled, nikdy editor.
Písma
Tři voliče na stejném panelu nastavují samostatné písmo pro každý druh textu – Nadpis, Text a Kód – což je to, co dělá dokument Markzen pocitově vysázeným:
- Nadpis — Oswald, Playfair Display, Merriweather, Raleway, Montserrat, Lora, Libre Baskerville, Bebas Neue, Abril Fatface, Cinzel.
- Tělo — 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.
Písma pro kód jsou vybrána pro jednu vlastnost nad rámec vzhledu: všechna kreslí znaky pro kreslení rámečků (│ ├ └ ─), z nichž jsou tvořeny výpisy stromů a ASCII diagramy, takže strom adresářů vložený do bloku kódu si zachová svůj tvar namísto rozpadu na mezery. Jsou to také varianty bez ligatur – písmo s ligaturami překreslí != jako jedno ≠, což je příjemné v editoru kódu a špatné v dokumentu, který má ukázat, co soubor skutečně říká. JetBrains Mono a Source Code Pro jsou dodávány v Markzen, takže fungují na stroji, který je nikdy neviděl a bez jakéhokoli připojení.
Velikost textu
Tlačítka Zvětšit text a Zmenšit text na panelu nástrojů mění velikost textu.
Téma a jazyk
V Nastavení → Zobrazení:
- Motiv — Světlý nebo Tmavý. Výchozí: Světlé.
- Jazyk — Rozhraní Markzen je přeloženo do více než padesáti jazyků, včetně písem zprava doleva (arabština, hebrejština) a CJK (čínština, japonština, korejština).
Kompatibilita
Referenční tabulky: co podporuje každý značkovací jazyk a každý druh živého obrázku, který Markzen umí nakreslit. Vše zde se týká co kde funguje – vysvětlení najdete v sekcích výše.
Co umí každý značkovací jazyk
| Značkovací jazyk | Otevírá soubory končící na | Živé obrázky | Panel obsahu | Vzorec ve větě | Nelze vyjádřit |
|---|---|---|---|---|---|
| Markdown | .md, .markdown |
všechny | ano | $…$ |
zarovnání textu |
| AsciiDoc | .adoc, .asciidoc, .asc |
všechny kromě style |
ano | pouze blok | přeškrtnutí |
| reStructuredText | .rst, .rest |
všechny kromě style |
ano | $…$ |
přeškrtnutí |
| Org | .org |
všechny kromě style |
ano | $…$ |
zarovnání doleva a doprava |
| Textile | .textile |
všechny kromě style |
ano | pouze blok | — |
| Djot | .dj |
všechny kromě style |
ano | $`…` |
— |
| MediaWiki | .wiki, .mediawiki, .wikitext |
všechny kromě style |
ano | <math> |
inline kód, přeškrtnutí, bloková citace, zarovnání textu |
| BBCode | .bbcode, .bb |
všechny kromě style |
ano | pouze blok | — |
Živé obrázky — blok style je jedinou výjimkou: aplikuje CSS na samotný dokument,
což podporuje pouze Markdown. Každý jiný druh obrázku funguje ve všech jazycích. V dokumentu BBCode
je blok napsán [code=mermaid]…[/code] namísto zpětných apostrofů; v MediaWiki,
<syntaxhighlight lang="mermaid">…</syntaxhighlight>.
Nelze vyjádřit — jedná se o omezení samotných značkovacích jazyků, nikoli Markzen: pokud jazyk nemá pro něco notaci, Markzen pro to nenabízí tlačítko, namísto psaní soukromého dialektu, který by si dokázal přečíst pouze on. Viz Vzorce uvnitř věty pro řádek s matematikou.
Každý druh obrázku
Napište značku za úvodní trojité zpětné apostrofy — ```mermaid — a blok se stane obrázkem.
| Kategorie | Obrázek | Značka bloku | Poznámky |
|---|---|---|---|
| Diagramy | Mermaid | mermaid |
vývojové diagramy, sekvenční, třídní, Ganttův, ER, stavový |
| Graphviz | graphviz |
jazyk DOT | |
| Cytoscape | cytoscape |
síťové grafy; posouvání a zoom v náhledu | |
| Markmap | markmap |
myšlenková mapa z odrážkového přehledu; kliknutím složit | |
| Timeline | timeline |
vertikální časová osa událostí | |
| Softwarové diagramy | Nomnoml | nomnoml |
UML |
| PlantUML | plantuml |
UML — jediný obrázek, který potřebuje připojení k internetu | |
| DBML | dbml |
diagramy databázových schémat | |
| Grafy | Chart.js | chartjs |
sloupcový, čárový, koláčový, radarový |
| Vega-Lite | vega-lite |
deklarativní grafy z JSON | |
| ECharts | echarts |
velké interaktivní grafy | |
| IT vývoj | Pseudocode | pseudocode |
sázecí algoritmy |
| Tabulator | tabulator |
tříditelná interaktivní tabulka | |
| Bytefield | bytefield |
rozložení bitových a bajtových polí | |
| QR Code | qrcode |
||
| Railroad | railroad |
syntaktické diagramy | |
| WaveDrom | wavedrom |
digitální časové diagramy | |
| Matematika | KaTeX | katex |
také $…$ ve větě — viz tabulka výše |
| AsciiMath | asciimath |
prostý text matematické notace | |
| Grafy | function-plot | fnplot |
vykreslení funkční křivky |
| JSXGraph | jsxgraph |
interaktivní geometrie | |
| Plotly | plotly |
vědecké a 3D grafy | |
| Vědy | SMILES | smiles |
diagramy chemických struktur |
| Hudba | ABC Notation | abc |
noty z prostého textu |
| VexFlow | vexflow |
ryté notové osnovy | |
| VexChords | vexchords |
diagramy kytarových akordů | |
| ChordPro | chordpro |
akordy nad textem | |
| MusicXML | musicxml |
kompletní partitury | |
| Hry | Chess | chess |
šachovnice z pozice FEN |
| Go Board | goboard |
9×9, 13×13 a 19×19 | |
| Dokument | Markzen | markzen |
neviditelný: umisťuje a dimenzuje obrázek pod ním, nebo přepisuje panel obsahu |
| Style | style |
neviditelný: CSS pro tento dokument — pouze Markdown |
Asociace souborů
V systému Windows může instalační program zaregistrovat Markzen jako obslužný program pro každý typ souboru s označením, který čte – všech patnáct rozšíření uvedených v Kompatibilita, napříč všemi osmi jazyky. Po registraci se dvojitým kliknutím na jeden z těchto souborů v Průzkumníku otevře přímo v Markzen, a pokud je nainstalováno několik editorů, stále můžete vybrat Markzen pomocí "Otevřít v programu…".
Klávesové zkratky
| Klávesa | Akce |
|---|---|
Ctrl+S |
Uložit |
Ctrl+Shift+S |
Uložit jako |
Ctrl+ + / Ctrl+ - |
Zvětšit / zmenšit velikost textu |
Standardní zkratky editoru – najít, nahradit, kopírovat, vložit, vrátit zpět, opakovat – a zkratky formátovacího panelu nástrojů (tučné Ctrl+B, kurzíva Ctrl+I, nadpis Ctrl+H, odkaz Ctrl+K a další) fungují v panelu editoru. Zkratka pro formátování existuje pouze tam, kde aktuální značení má danou konstrukci – Ctrl+D nedělá nic v dokumentu AsciiDoc, který nemá vlastní přeškrtnutí (viz Editor).
Tipy
- Skryjte editor pro čtení. Jediný pohled s náhledem promění Markzen v čistou čtečku a pět šablon stylů vám umožní nastavit, jak vypadá.
- Jeden dokument, každý druh obsahu. Vývojový diagram Mermaid, rovnice KaTeX a notový zápis mohou sedět vedle prostého textu – všechny se vykreslí dohromady a všechny přežijí export do PDF a HTML.
- Šablona stylu je vzhled exportu. Jakákoli šablona, kterou vyberete, je styl zapečený do výstupu PDF a HTML, takže ji nastavte před exportem.
- Pište ve značkování, které se vám líbí, dodávejte ve formátu, který potřebují. Navrhujte v Markdownu (nebo kterémkoli z osmi), pak použijte Převést na pro soubor Word, prezentaci, e-knihu nebo zdroj LaTeXu – nejsou potřeba žádné samostatné nástroje.