Ohjeet

Mikä on Markzen?

Markzen on työpöytäeditori kevyille merkintäkielille – Markdown ja kuusi muuta – jossa on reaaliaikainen, täysin tyylitelty esikatselu. Kirjoitat vasemmalle pelkkää tekstiä, joka on merkitty yksinkertaisilla välimerkeillä, ja Markzen renderöi sen muotoiltuna HTML:nä oikealle kirjoittaessasi.

Mikä erottaa sen tavallisesta Markdown-editorista, on edestakainen matka. Markzen lukee kahdeksaa merkintäkieltä, renderöi 30 reaaliaikaista laajennusta (kaavioita, taulukoita, matemaattisia kaavoja, nuotteja, shakkilautoja, QR-koodeja) asiakirjan sisällä ja vie yli kahteenkymmeneen muotoon – e-kirjoja, Word, PowerPoint, LaTeX, Jupyter-muistikirjoja ja paljon muuta. Kirjoita kerran, ja anna tulos melkein minä tahansa. Muunnin on sisäänrakennettu, joten ulkoisia työkaluja ei tarvitse asentaa.

Voit avata olemassa olevan tiedoston tai vain alkaa kirjoittaa – tiedostoa ei tarvitse avata ensin.

Editori

Vasen ruutu on täysi CodeMirror-koodieditori, ei pelkkä tekstikenttä: siinä on syntaksikorostus kirjoittamallesi merkintäkielelle, muotoilutyökalupalkki (lihavointi, kursivointi, otsikot, luettelot ja paljon muuta, sekä erilliset painikkeet linkkien ja kuvien lisäämiseen – katso Linkit ja kuvat – ja taulukon lisäämiseen, katso Taulukot ja laskentataulukot), sekä etsi ja korvaa -haku. Vakiomuokkauspikakomennot – kopioi, liitä, kumoa, tee uudelleen – toimivat odotetusti.

Kirjoitat yhteen kahdeksasta kevyestä merkintäkielestä. Nämä ovat pelkkätekstimuotoja, jotka ilmaisevat rakenteen välimerkeillä (# otsikolle, * korostukselle) piilotetun tyylittelyn sijaan, joten asiakirja pysyy luettavana tekstinä ja diff-ystävällisenä versionhallinnassa. Markzen lukee kaikki kahdeksan ja päättää tiedoston kielen sen tiedostopäätteen perusteella – et koskaan valitse muotoa manuaalisesti. Yhteensopivuus luettelee, mitkä tiedostopäätteet avaavat minkäkin kielen.

Jokaisella kielellä on omat käytäntönsä ja oma olemassa oleva asiakirjaekosysteeminsä; Markzen renderöi jokaisen omalla dialektillaan sen sijaan, että muuttaisi kaiken ensin Markdowniksi. BBCode on ainoa, jolla ei ole yhtä standardia – jokainen foorumi keksi oman varianttinsa – joten Markzen lukee sitä anteliaasti, hyväksyen yleiset kirjoitusasut rinnakkain ([list] tai [ul], [h1] tai [heading=1]) ja jättäen kaikki tunnistamattomat tagit näkyviin pelkkänä tekstinä sen sijaan, että nieleisi ne. Vaihtaaksesi asiakirjan kirjoitusmerkintätyyppiä, käytä työkalupalkin Muunna muotoon-valikkoa (katso Muunna ja vie alla).

Kaikki kielet eivät voi ilmaista kaikkea. Muotoilutyökalupalkissa on samat painikkeet jokaisessa asiakirjassa, mutta Markzen kirjoittaa aina vain merkintää, jonka kieli itse määrittelee – se ei koskaan keksi omaa dialektia peittääkseen aukon. Painike, jolle nykyisellä kielellä ei ole merkintää, on harmaana. Lihavointi, kursivointi, otsikot, luettelot, koodilohkot, linkit, kuvat, viivat ja taulukot ovat saatavilla kaikissa kahdeksassa; kourallinen puutteita on lueteltu kohdassa Yhteensopivuus. Markdownin puutteet yllättävät ihmisiä: sillä ei ole standardia tapaa keskittää kappaletta, joten Markzen ei tarjoa siinä tasauspainikkeita sen sijaan, että kirjoittaisi jotain, mitä vain jotkut lukijat kunnioittaisivat.

Tekstin koko asetetaan työkalupalkin Suurenna tekstiä- ja Pienennä tekstiä-painikkeilla. Editoriruutu voidaan myös piilottaa kokonaan – silloin Markzen muuttuu puhtaaksi lukijaksi (katso Live-esikatselu).

Linkit ja kuvat

Muotoilutyökalupalkissa on kaksi erillistä painiketta linkin tai kuvan lisäämiseksi asiakirjaan, ja kumpikin avaa pienen ponnahdusikkunan suoraan kohdistimen kohdalle. Linkki (Ctrl+K) – tai paina Ctrl+K – lisää hyperlinkin: kirjoita linkin teksti ja sen osoite, ja Markzen kirjoittaa sille oikean merkinnän. Kuva lisää kuvan samalla tavalla, muutamilla lisävalinnoilla, jotka käsitellään alla.

Molemmat kirjoitetaan nykyisen asiakirjan käyttämällä merkinnällä – AsciiDoc-tiedostoon lisätty linkki tulee ulos AsciiDocina, Org-tiedostoon Orgina ja niin edelleen kaikilla kahdeksalla kielellä.

Aloita jo olemassa olevasta osoitteesta. Liitä verkko-osoite asiakirjaan, valitse se ja paina Ctrl+K: Markzen näkee, että valinta on osoite eikä sanoja, laittaa sen ponnahdusikkunan osoitekenttään ja jättää kohdistimen tyhjään tekstikenttään odottamaan, mitä linkin pitäisi sanoa. Ilman sitä valittu osoite olisi tullut linkin näkyväksi tekstiksi – linkiksi, joka lukee pelkkänä URL-osoitteena. Absoluuttiset tiedostopolut lasketaan myös osoitteiksi, Windowsissa ja muualla, joten sama pikanäppäin muuttaa liitetyn polun linkiksi kyseiseen tiedostoon.

Muokkaa jo olemassa olevaa linkkiä tai kuvaa. Aseta kohdistin mihin tahansa olemassa olevaan linkkiin tai kuvaan ja avaa ponnahdusikkuna uudelleen (painike tai Ctrl+K): Markzen tunnistaa rakenteen, lataa sen nykyisen tekstin ja osoitteen ponnahdusikkunaan ja korvaa koko asian, kun vahvistat – joten muokkaat sitä paikan päällä sen sijaan, että vahingossa sisäkkäisit uuden linkin vanhan sisään.

Kuvan osalta ponnahdusikkuna tarjoaa myös Etsi kuva-painikkeen tiedoston valitsemiseksi levyltä polun kirjoittamisen sijaan – se avautuu kansioon, josta viimeksi otit kuvan, erillään siitä, mistä asiakirjasi tulevat – ja yhden tärkeän valinnan: onko kuva upotettu vai linkitetty.

Upotetut vai linkitetyt kuvat

Kun lisäät kuvan, Markzen voi tallentaa sen asiakirjaan kahdella tavalla:

• Linkitetty – asiakirja vain osoittaa kuvaan tiedostopolun tai verkko-osoitteen kautta. Asiakirjatiedosto pysyy pienenä, mutta kuvan on matkustettava sen mukana (tai pysyttävä tavoitettavissa URL-osoitteessaan), tai se ei näy muualla. Tämä on oletusarvo.
• Upotettu – kuvan todelliset tavut kirjoitetaan asiakirjaan tekstinä (base64 data:-lohko), joten tiedosto on täysin itsenäinen: yksi tiedosto sisältää kaiken, eikä mitään voi kadottaa. Kompromissi on koko – asiakirja kasvaa kuvan painon verran, eikä upotettu kuva voi käyttää suhteellista polkua.

Valitse Upotettu, kun haluat yhden siirrettävän tiedoston luovutettavaksi; valitse Linkitetty, kun pidät kuvia asiakirjan vieressä ja haluat tiedoston pysyvän pienenä.

Linkitetyn kuvan osalta ilmestyy yksi lisäasetus: Suhteellinen polku. Kun kuva sijaitsee asiakirjan omassa kansiossa (tai alikansiossa), tämän valitseminen kirjoittaa viittauksen lyhyenä suhteellisena polkuna täyden absoluuttisen polun sijaan, joten linkki toimii edelleen, kun siirrät asiakirjan ja sen kuvat yhdessä. Sitä tarjotaan vain, kun kuva on asiakirjan kansion sisällä – muuten suhteellista polkua ei ole kirjoitettavaksi.

Upotetut kuvat pysyvät siistinä editorissa. Base64-upotettu kuva on pitkä tekstiseinä, joka muuten hautaisi ympäröivät rivit, joten Markzen taittaa jokaisen niistä pieneksi siruksi, joka näyttää sen tyypin ja koon (esimerkiksi 🖼 webp · 38 KB). Siru on vain näyttöä varten – taustalla oleva teksti on koskematon, joten tallentaminen, kopioiminen tai leikkaaminen kuljettaa aina koko kuvan, ja kohdistin hyppää sirun yli yhtenä yksikkönä.

Tiedostot, välilehdet ja tallennus

Markzen pitää auki niin monta dokumenttia kuin haluat, kukin omalla välilehdellään, joten voit työskennellä useiden tiedostojen parissa ja vaihtaa niiden välillä vapaasti. Sinun ei tarvitse avata tiedostoa aloittaaksesi – ala kirjoittaa jo olemassa olevaan tyhjään dokumenttiin tai käytä työkalupalkin tiedostopainikkeita:

• Uusi asiakirja – avaa lyhyen valikon (Luo uusi), jossa luetellaan kahdeksan merkintäkieltä; valitse yksi aloittaaksesi uuden, tyhjän dokumentin, joka on kirjoitettu kyseisellä merkinnällä, uudessa välilehdessä.
• Avaa Markdown-tiedosto – selaa olemassa olevaa tiedostoa ja avaa se. Valitsin hyväksyy kaikki kahdeksan merkintämuotoa, ja Markzen valitsee oikean tiedoston laajennuksen perusteella. Se avautuu kansioon, josta viimeksi otit dokumentin, ja se muistetaan istuntojen välillä, joten sinun ei tarvitse aloittaa tyhjästä joka kerta.
• Tallenna – kirjoittaa aktiivisen dokumentin takaisin tiedostoonsa. Dokumentti, jota ei ole koskaan tallennettu, siirtyy Tallenna nimellä -toimintoon, jotta voit nimetä sen ensin.
• Tallenna nimellä – tallentaa aktiivisen dokumentin uuteen tiedostoon jättäen alkuperäisen koskemattomaksi.

Voit myös vetää tiedoston tiedostonhallinnasta ja pudottaa sen ikkunaan avataksesi sen.

Jokainen avoin dokumentti on välilehti ikkunan yläreunassa. Tallentamaton välilehti on merkitty pisteellä, ja välilehti, jonka merkintä ei ole Markdown, sisältää pienen muotomerkin (esimerkiksi adoc). Välilehden × sulkee sen – ja dokumentin sulkeminen tallentamattomilla muutoksilla ei koskaan hylkää niitä hiljaisesti: välilehteen ilmestyy rivipalkki, jotta voit ensin Tallenna tai Hylkää.

Dokumentin ollessa auki Markzen tarkkailee sen tiedostoa levyllä. Jos tiedosto muuttuu toisessa ohjelmassa eikä sinulla ole omia tallentamattomia muokkauksia, Markzen hakee uuden version automaattisesti; jos sinulla on tallentamattomia muokkauksia, se kysyy ensin – rivipalkki Lataa uudelleen antaa sinun päättää, otatko levyn version vai pidätkö omasi.

Reaaliaikainen esikatselu

Oikeanpuoleinen ruutu näyttää dokumentin tyyliteltynä HTML-muodossa, ja se päivittyy reaaliaikaisesti kirjoittaessasi. Linkit toimivat, taulukot kohdistuvat, koodi näytetään tasalevyisessä lohkossa, tehtävälistoihin tulee valintaruudut, ja jokainen renderöintilaajennuslohko (katso alla) piirtää kuvansa paikoilleen. Esikatselu on uskollinen kuva siitä, miltä HTML- tai PDF-vienti näyttää.

Jos Markdown-dokumentti alkaa YAML-etualalohkolla — --- key: value --- -osiolla, jonka työkalut kuten Jekyll, Hugo ja Obsidian sijoittavat aivan alkuun — Markzen renderöi sen siistinä metatietokorttina dokumentin yläpuolelle, sen sijaan että antaisi sulkevan ---:n muuttua irralliseksi otsikoksi.

Asettelutilat

Kolmen työkalupainikkeen ryhmä määrittää, mitä ikkuna näyttää:

• Jaettu näkymä — editori ja esikatselu vierekkäin. Vedä jakajaa muuttaaksesi kummankin saamaa tilaa.
• Näytä editori — pelkkä editori, joka täyttää ikkunan häiriöttömän kirjoittamisen mahdollistamiseksi.
• Näytä esikatselu — pelkkä esikatselu, puhdas koko leveyden lukija.

Sisällysluettelo

Sisällysluettelo-painike avaa paneelin, joka rakentuu automaattisesti jokaisesta dokumentin otsikosta (#, ##, ###, …). Napsauta mitä tahansa kohtaa vierittääksesi esikatselun kyseiseen osioon. Jokainen otsikko, jonka alla on alaotsikoita, näyttää nuolen: napsauta sitä Tiivistä kyseinen osio ja piilota sen sisäkkäiset otsikot, tai Laajenna tuodaksesi ne takaisin — jotta voit taittaa pitkän jäsennyksen vain niihin osiin, joissa työskentelet. Pienet 2 / 3 / 4 -painikkeet paneelin otsikossa rajoittavat jäsennyksen kyseiseen otsikkosyvyyteen — hyödyllistä pitkässä dokumentissa, kun haluat nähdä vain ylimmät tasot — ja aktiivisen painikkeen uudelleen napsauttaminen tuo kaikki tasot takaisin. Paneelin kokoa voi muuttaa vetämällä sen vasenta reunaa ja se romahtaa vapauttaakseen lukutilaa. Se on navigointiapu vain sovelluksen sisällä — se ei koskaan näy viennissä.

Oman jäsennyksen antaminen. Jos otsikot eivät ole haluamasi jäsennys, dokumentti voi sisältää oman. markzen-tunnisteella varustettu aidattu lohko, jonka ensimmäinen rivi on toc, korvaa luodun paneelin sen alle kirjoitetulla luettelolla:

`markdown

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

Sisennys määrittää tason, ja jokainen merkintä osoittaa ankkuriin, jonka on oltava olemassa itse dokumentissa — otsikkoon, jolle annoit eksplisiittisen id:n, tai pelkkään <a id="intro"></a>. Itse lohko ei piirrä mitään: se on metatietoa, jonka paneeli lukee.

Taulukot ja laskentataulukot

Taulukot siirtyvät sujuvasti Markzen-sovelluksen ja minkä tahansa laskentataulukon välillä. Liitä sarkaineroteltu teksti – kopioitu Excelistä, Google Sheetsistä, Wordista tai verkkotaulukosta – editoriin, ja Markzen muuttaa sen oikeaksi taulukoksi, joka on kirjoitettu dokumentin omalla merkintäkielellä, sen sijaan, että se pudottaisi sisään seinällisen sarkainmerkkejä. Liittämislukija on lainausmerkkien huomioiva (se käsittelee oikein soluja, jotka sisältävät sarkaimia, rivinvaihtoja tai lainausmerkkejä) ja laukeaa vain, kun leikepöydällä on puhdas suorakulmainen ruudukko, jossa on vähintään kaksi saraketta; kaikki muu liitetään tavallisena tekstinä.

Voit myös aloittaa taulukon alusta. Työkalupalkin Lisää taulukko-painike avaa pienen ruudukon – pyyhkäise sen yli valitaksesi haluamasi rivien ja sarakkeiden määrän, ja Markzen kirjoittaa sen kokoisen tyhjän taulukon dokumentin omalla merkintäkielellä, valmiina kirjoitettavaksi. Ensimmäinen rivi on otsikkorivi.

Myös päinvastainen toimii. Vie hiiri minkä tahansa esikatselussa renderöidyn taulukon päälle, ja sen kulmaan ilmestyy kopiointipainike: se kopioi taulukon takaisin sarkaineroteltuna tekstinä, joka putoaa suoraan laskentataulukon soluun tai Word-dokumenttiin. Nämä kopiointipainikkeet ovat vain esikatselun helpotusta varten – ne poistetaan kaikista viennistä ja muunnoksista, joten jaettu tiedosto sisältää vain puhtaan taulukon.

Renderöintilaajennukset

Markzen laajentaa standardimerkintää aidattujen koodilohkojen avulla. Heti avaavien kolmen takahaksen jälkeinen kielitunniste määrittää, miten lohko renderöidään: tunnistetunniste Markzen tunnistaa laajennuksena piirtää elävän kuvan koodin näyttämisen sijaan.

Jokainen kuvatyyppi piirretään omalla renderöintimoottorillaan, ja Markzen hakee moottorin ensimmäisen kerran, kun asiakirja todella pyytää sitä, sen sijaan, että lataisi kaikki käynnistyksen yhteydessä – siksi sovellus käynnistyy lähes välittömästi, ja siksi tietyn tyyppisen ensimmäisen kaavion ilmestyminen voi kestää hetken, kun taas jokainen myöhempi ilmestyy välittömästi.

Esimerkiksi tämä lähde:

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

renderöidään elävänä vuokaaviona, ei koodilistauksena – ja se pysyy vuokaaviona myös PDF- ja HTML-viennissä.

Kaaviot, kuvaajat, matematiikka, nuotit, shakki- ja Go-laudat, QR-koodit ja paljon muuta ovat sisäänrakennettuja – Yhteensopivuus listaa jokaisen niistä tunnisteineen.

Jokaisella laajennuksella on oma kielitunnisteensa (mermaid, chartjs, katex, abc, chess, …). Voit yhdistää niin monta kuin haluat tavallisen proosan kanssa yhdessä asiakirjassa – ne kaikki renderöityvät yhdessä. Se, onko kuva edelleen kuva, kun asiakirja poistuu Markzen-sovelluksesta, riippuu siitä, minne lähetät sen – katso Muunna ja vie alla.

Kaavat lauseen sisällä

Matemaattinen kaava voi olla oma lohko – katex- tai asciimath-lohko, joka seisoo yksin ja on keskitetty kuten yhtälö oppikirjassa. Tämä toimii kaikissa kahdeksassa merkintäkielessä.

Kaava voi myös olla lauseen sisällä, niin että "pinta-ala on pii r neliö" luetaan yhtenä proosana, jossa on todellisia symboleja. Tämä riippuu siitä, onko merkintäkielessä sille oma merkintä, ja jokainen kirjoittaa sen eri tavalla – merkintä kieltä kohti on kohdassa Yhteensopivuus.

Textile ja BBCode ovat kaksi poikkeusta, ja se on näiden kielten rajoitus pikemminkin kuin Markzen-sovelluksen: kumpikaan ei koskaan määritellyt tapaa kirjoittaa matematiikkaa. Textile- tai BBCode-asiakirjassa kaavan on siis oltava oma lohkonsa. Mitään ei menetetä – kaava renderöityy ja säilyy viennissä – sitä ei vain voi kutoa proosariviin.

Kuvan sijoittaminen ja koon muuttaminen

Vie hiiri renderöidyn kuvan päälle esikatselussa, niin sen viereen ilmestyy pieni paneeli: tasaus-painikkeet (vasen, keskitetty, oikea) ja – niille kuvatyypeille, joiden kokoa voi muuttaa – leveys- ja korkeus-kentät pikseleinä. remove style block tyhjentää ne uudelleen.

Tätä valintaa ei säilytetä jossain näkymättömässä paikassa: paneeli kirjoittaa sen asiakirjaan lyhyenä markzen-tunnisteella varustettuna lohkona, joka sijoitetaan välittömästi sen kuvan eteen, johon se liittyy.

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

Näin asettelu kulkee tiedoston mukana – se on osa sitä, mitä tallennat, luovutat ja viet, millä tahansa koneella. Voit yhtä hyvin kirjoittaa lohkon käsin: yksi direktiivi riviä kohti, align (left, center tai right), width ja height pikseleinä, aina soveltaen suoraan sen alapuolella olevaan lohkoon.

Yhden asiakirjan tyylittely CSS:llä

Markdown-asiakirja voi sisältää myös oman tyylitiedostonsa aidatussa style-tunnisteella varustetussa lohkossa:

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

Säännöt koskevat kyseisen asiakirjan esikatselua sekä sen PDF- ja HTML-vientejä, minkä tahansa aktiivisen tyylimallin lisäksi – tapa antaa yhdelle asiakirjalle oma ulkoasu muuttamatta asetuksiasi kaikelle muulle. Vain tavalliset valitsimet: at-sääntöjä, kuten @media ja @keyframes, ei tueta, ja lohko toimii vain Markdown-asiakirjoissa.

Muunna ja vie

Työkalupalkin Muunna muotoon-valikko on paikka, josta valmis asiakirja lähtee Markzen-sovelluksesta. Se tekee kaksi erillistä asiaa.

Muunna toiseen merkintäkieleen. Kohdassa Kevyt merkintä avoin asiakirja kirjoitetaan uudelleen joksikin seitsemästä muusta merkintäkielestä – AsciiDoc, BBCode, Djot, MediaWiki, Org, reStructuredText tai Textile. Hyödyllinen, kun wiki haluaa MediaWikin, foorumi BBCodea, julkaisija AsciiDocia tai siirrät muistiinpanoja ekosysteemien välillä. Jokainen kahdeksasta näkyy valikossa kerran merkintäkielenä: täältä MediaWikiksi tallennettu asiakirja on sama tiedosto, jonka saisit mistä tahansa muualta.

Vie valmiiseen muotoon. Asiakirja annetaan mukana tulevalle muuntimelle, joka tuottaa yli kaksikymmentä asiakirjamuotoa, ryhmiteltynä käyttötarkoituksen mukaan:

Luokka	Muodot
E-kirjat	EPUB 3, FictionBook2
Tekstinkäsittely	Microsoft Word (.docx), OpenDocument (.odt), Rich Text Format (.rtf)
Esitys	Microsoft PowerPoint (.pptx), reveal.js (.html)
Ladonta	InDesign ICML, LaTeX (.tex), Typst (.typ)
XML	DocBook, JATS, OpenDocument XML, TEI Simple
Muistikirja	Jupyter Notebook (.ipynb)
Jäsennys	OPML (.opml)

Muunnin toimitetaan Markzen-sovelluksen mukana – mitään ylimääräistä ei tarvitse ladata tai määrittää. Näiden lisäksi työkalupalkissa on kolme nopeaa tulostusvaihtoehtoa: Tallenna PDF-muodossa ja Tallenna HTML-muodossa vievät renderöidyn asiakirjan täsmälleen esikatselun mukaisena (tyylimalli, fontit ja laajennuskuvat mukaan lukien), ja Tulosta lähettää sen tulostimelle. Koodifontti kulkee viedyn tiedoston sisällä, joten koodilohko tai ASCII-kaavio näkyy lukijan koneella samalta kuin sinä näit sen, riippumatta siitä, onko heillä kyseinen fontti asennettuna.

Mikä siirtyy ja mikä ei. Renderöintilaajennuksen kuva pysyy kuvana vain, jos kohdemuoto voi sisältää kuvan, joten asiakirja poistuu Markzen-sovelluksesta jompaakumpaa kahdesta reitistä:

• Näkemäsi asiakirjana – kolme juuri kuvattua työkalupalkin tulostusvaihtoehtoa (PDF, HTML, tulostus) ja viisi yllä olevan taulukon muodoista: EPUB 3, Microsoft Word (.docx), OpenDocument (.odt), Microsoft PowerPoint (.pptx) ja Rich Text Format (.rtf). Kaaviot, kaavat ja nuotit kirjoitetaan kuvina ja ne saapuvat ehjinä.
• Asiakirjan lähdetekstinä – kaikki muut kohteet ja kaikki muunnokset toiseen merkintäkieleen. Proosa, otsikot, luettelot, taulukot ja linkit muunnetaan; mermaid- tai katex-lohko saapuu tavallisena koodilohkona, joka sisältää kirjoittamasi lähteen, koska näissä muodoissa ei ole kuvaa, jonka Markzen voisi niille antaa.

Joten kaavioiden ympärille rakennettu asiakirja kannattaa parhaiten antaa PDF-, HTML-, EPUB-, Word-, OpenDocument-, PowerPoint- tai RTF-muodossa. LaTeX, Typst, reveal.js ja muut antavat sinulle silti koko asiakirjan – kunkin kuvan lähde jätetään paikalleen, valmiina kyseisen ekosysteemin omiin työkaluihin.

Vienti komentoriviltä

Markzen toimii myös avaamatta ikkunaa. Anna Markzen-suoritettavalle tiedostolle lähdetiedosto ja -o tulostuspolun kanssa, ja se renderöi asiakirjan ja kirjoittaa viennin suoraan levylle:

markzen.exe report.md -o report.pdf

Lähde voi olla mikä tahansa kahdeksasta merkintämuodosta, joita Markzen lukee; tuloste on PDF- tai HTML-tiedosto, joka valitaan tulosteen nimen laajennuksella. Vienti käy läpi saman renderöinnin kuin itse sovellus, joten kaaviot, kaavat ja kaikki muut laajennuslohkot tulevat ulos elävinä kuvina. Viennit käyttävät oletustyylimallia ja fontteja – komentorivi toimii omassa puhtaassa profiilissaan, erillään sovelluksesta, mikä tarkoittaa myös sitä, että se toimii hyvin, vaikka Markzen on jo auki.

Useita asiakirjoja voidaan viedä yhdellä kutsulla – anna mikä tahansa määrä source -o output -pareja ja yksi käynnistys renderöi ne kaikki, murto-osalla kustannuksista, jotka aiheutuisivat käynnistämisestä kerran tiedostoa kohden:

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

Fontit ja ulkoasu

Markzen on rakennettu siten, että asiakirja näyttää ladotulta eikä geneeriseltä. Tämän hallintalaitteet sijaitsevat yhdessä työkalupalkissa Tyyli ja fontit-painikkeen takana, joten voit säätää niitä lukiessasi; teema ja käyttöliittymän kieli löytyvät kohdasta Asetukset → Näyttö.

Tyylimalli

Tyyli tarjoaa viisi esikatselutyyliä: Standardi, GitHub, Kirja, Moderni, Minimalistinen. Valitsemasi malli on myös tyyli, joka sovelletaan PDF- ja HTML-vienteihin, joten se päättää, miten jaettu asiakirja luetaan – valitse Kirja tai Moderni luovutettavaksi, Minimalistinen häiriöttömään lukemiseen. Malli muotoilee vain esikatselun, ei koskaan editoria.

Fontit

Kolme valitsinta samassa paneelissa asettaa erillisen fontin jokaiselle tekstityypille – Otsikko, Leipäteksti ja Koodi – mikä saa Markzen-asiakirjan tuntumaan ladotulta:

• Otsikko — Oswald, Playfair Display, Merriweather, Raleway, Montserrat, Lora, Libre Baskerville, Bebas Neue, Abril Fatface, Cinzel.
• Leipäteksti — Inter, Roboto, Georgia, Lato, Source Serif 4, Nunito, PT Serif, Crimson Text, Libre Franklin, Open Sans.
• Koodi — JetBrains Mono, Source Code Pro, Cascadia Mono, Fira Mono.

Koodifontit on valittu yhden ominaisuuden perusteella ulkonäön lisäksi: ne kaikki piirtävät ruutupiirrosmerkit (│ ├ └ ─), joista puulistaukset ja ASCII-kaaviot koostuvat, joten koodilohkoon liitetty hakemistopuu säilyttää muotonsa sen sijaan, että se hajoaisi aukkoihin. Ne ovat myös ligatuurittomia variantteja – ligatuureja sisältävä fontti piirtää != uudelleen yhtenä ≠-merkkinä, mikä on miellyttävää koodieditorissa ja väärin asiakirjassa, jonka on tarkoitus näyttää, mitä tiedosto todella sanoo. JetBrains Mono ja Source Code Pro toimitetaan Markzen-sovelluksen mukana, joten ne toimivat koneella, joka ei ole koskaan nähnyt niitä, eikä vaadi yhteyttä.

Tekstin koko

Työkalupalkin Suurenna tekstiä- ja Pienennä tekstiä-painikkeet muuttavat tekstin kokoa.

Teema ja kieli

Kohdassa Asetukset → Näyttö:

• Teema — Vaalea tai Tumma. Oletus: Vaalea.
• Kieli — Markzen-sovelluksen oma käyttöliittymä on käännetty yli viiteenkymmeneen kieleen, mukaan lukien oikealta vasemmalle kirjoitettavat kielet (arabia, heprea) ja CJK (kiina, japani, korea).

Yhteensopivuus

Viitetaulukot: mitä kukin merkintäkieli tukee ja minkälaisia live-kuvia Markzen voi piirtää. Kaikki tässä koskee sitä, mikä toimii missä – selitykset löytyvät yllä olevista osioista.

Mitä kukin merkintäkieli voi tehdä

Merkintäkieli	Avaa tiedostoja, jotka päättyvät	Live-kuvat	Sisältöpaneeli	Kaava lauseessa	Ei voi ilmaista
Markdown	.md, .markdown	kaikki	kyllä	$…$	tekstin tasaus
AsciiDoc	.adoc, .asciidoc, .asc	kaikki paitsi style	kyllä	vain lohko	yliviivaus
reStructuredText	.rst, .rest	kaikki paitsi style	kyllä	$…$	yliviivaus
Org	.org	kaikki paitsi style	kyllä	$…$	vasen ja oikea tasaus
Textile	.textile	kaikki paitsi style	kyllä	vain lohko	—
Djot	.dj	kaikki paitsi style	kyllä	$`…`	—
MediaWiki	.wiki, .mediawiki, .wikitext	kaikki paitsi style	kyllä	<math>	inline-koodi, yliviivaus, lohkolainaus, tekstin tasaus
BBCode	.bbcode, .bb	kaikki paitsi style	kyllä	vain lohko	—

Live-kuvat – style-lohko on ainoa poikkeus: se soveltaa CSS:ää itse asiakirjaan, mitä vain Markdown tukee. Kaikki muut kuvatyypit toimivat kaikilla kielillä. BBCode-dokumentissa lohko kirjoitetaan [code=mermaid]…[/code] eikä takahakasulkeilla; MediaWikissä <syntaxhighlight lang="mermaid">…</syntaxhighlight>.

Ei voi ilmaista – nämä ovat merkintäkielten itsensä rajoituksia, eivät Markzen:n: jos kielellä ei ole merkintää jollekin, Markzen ei tarjoa sille painiketta sen sijaan, että kirjoittaisi yksityisen murteen, jonka vain se voisi lukea takaisin. Katso Kaavat lauseen sisällä matematiikkariviltä.

Kaikenlaiset kuvat

Kirjoita tunniste avaavien kolmen takahakasulkeen jälkeen – ```mermaid – ja lohkosta tulee kuva.

Kategoria	Kuva	Lohkotunniste	Huomautuksia
Kaaviot	Mermaid	mermaid	vuokaaviot, sekvenssi, luokka, Gantt, ER, tila
	Graphviz	graphviz	DOT-kieli
	Cytoscape	cytoscape	verkkokaaviot; panorointi ja zoomaus esikatselussa
	Markmap	markmap	miellekartta luetteloidusta jäsennyksestä; napsauta taitellaksesi
	Timeline	timeline	pystysuora tapahtuma-aikajana
Ohjelmistokaaviot	Nomnoml	nomnoml	UML
	PlantUML	plantuml	UML – ainoa kuva, joka tarvitsee internet-yhteyden
	DBML	dbml	tietokantakaaviot
Kaaviot	Chart.js	chartjs	pylväs, viiva, ympyrä, tutka
	Vega-Lite	vega-lite	deklaratiiviset kaaviot JSON:sta
	ECharts	echarts	suuret interaktiiviset kaaviot
IT-kehitys	Pseudocode	pseudocode	ladotut algoritmit
	Tabulator	tabulator	lajiteltava interaktiivinen taulukko
	Bytefield	bytefield	bitti- ja tavukenttäasettelut
	QR Code	qrcode
	Railroad	railroad	syntaksikaaviot
	WaveDrom	wavedrom	digitaaliset ajoituskaaviot
Matematiikka	KaTeX	katex	myös $…$ lauseessa – katso yllä oleva taulukko
	AsciiMath	asciimath	pelkkä tekstimatematiikan merkintä
Graafit	function-plot	fnplot	piirrä funktion käyrä
	JSXGraph	jsxgraph	interaktiivinen geometria
	Plotly	plotly	tieteelliset ja 3D-kaaviot
Tieteet	SMILES	smiles	kemialliset rakennekaaviot
Musiikki	ABC Notation	abc	nuotit pelkästä tekstistä
	VexFlow	vexflow	kaiverretut nuottiviivastot
	VexChords	vexchords	kitarasointukaaviot
	ChordPro	chordpro	soinnut sanoitusten yläpuolella
	MusicXML	musicxml	täydet partituurit
Pelit	Chess	chess	lauta FEN-asemasta
	Go Board	goboard	9×9, 13×13 ja 19×19
Asiakirja	Markzen	markzen	näkymätön: sijoittaa ja mitoittaa sen alla olevan kuvan tai ohittaa sisältöpaneelin
	Style	style	näkymätön: CSS tälle asiakirjalle – vain Markdown

Tiedostoyhteydet

Windowsissa asennusohjelma voi rekisteröidä Markzen-sovelluksen käsittelijäksi jokaiselle sen lukemalle merkintätiedostotyypille – kaikki viisitoista laajennusta, jotka on lueteltu kohdassa Yhteensopivuus, kaikilla kahdeksalla kielellä. Kun tiedostot on rekisteröity, kaksoisnapsauttamalla yhtä näistä tiedostoista Resurssienhallinnassa avaa sen suoraan Markzen-sovelluksessa, ja jos useita muokkausohjelmia on asennettu, voit silti valita Markzen-sovelluksen "Avaa sovelluksella..." -toiminnolla.

Pikanäppäimet

Näppäin	Toiminto
Ctrl+S	Tallenna
Ctrl+Shift+S	Tallenna nimellä
Ctrl+ + / Ctrl+ -	Suurenna / pienennä tekstin kokoa

Vakioeditorin pikanäppäimet – etsi, korvaa, kopioi, liitä, kumoa, tee uudelleen – ja muotoilutyökalupalkin pikanäppäimet (lihavointi Ctrl+B, kursivointi Ctrl+I, otsikko Ctrl+H, linkki Ctrl+K ja paljon muuta) toimivat editoriruudussa. Muotoilupikanäppäin on olemassa vain, jos nykyisessä merkinnässä on kyseinen rakenne – Ctrl+D ei tee mitään AsciiDoc-dokumentissa, jossa ei ole omaa yliviivausta (katso Editori).

Vinkkejä

• Piilota editori lukeaksesi. Yksittäinen näkymä esikatselun kanssa muuttaa Markzen-sovelluksen puhtaaksi lukijaksi, ja viisi tyylimallia antavat sinun määrittää sen ulkoasun.
• Yksi dokumentti, kaikenlaista sisältöä. Mermaid-vuokaavio, KaTeX-yhtälö ja nuotit voivat olla tavallisen proosan rinnalla – ne kaikki renderöityvät yhdessä ja kaikki säilyvät PDF- ja HTML-viennissä.
• Tyylimalli on viennin ulkoasu. Mikä tahansa valitsemasi malli on PDF- ja HTML-tulosteeseen leivottu tyyli, joten aseta se ennen vientiä.
• Kirjoita haluamallasi merkintäkielellä, toimita tarvitsemassasi muodossa. Luonnostele Markdownilla (tai millä tahansa kahdeksasta), ja käytä sitten Muunna-toimintoa Word-tiedostoon, esitykseen, e-kirjaan tai LaTeX-lähteeseen – erillisiä työkaluja ei tarvita.