Pomoc

Czym jest Markzen?

Markzen to edytor desktopowy dla lekkich języków znaczników — Markdown i sześciu innych — z podglądem na żywo, w pełni stylizowanym. Po lewej stronie piszesz zwykły tekst oznaczony prostą interpunkcją, a Markzen renderuje go jako sformatowany HTML po prawej stronie, w miarę pisania.

To, co odróżnia go od zwykłego edytora Markdown, to dwukierunkowość. Markzen czyta osiem języków znaczników, renderuje 30 rozszerzeń na żywo (diagramy, wykresy, formuły matematyczne, partytury muzyczne, szachownice, kody QR) wewnątrz dokumentu i eksportuje do ponad dwudziestu formatów — e-booków, Worda, PowerPointa, LaTeX-a, notatników Jupyter i innych. Napisz raz, a wynik możesz przekazać w niemal dowolnej formie. Konwerter jest wbudowany, więc nie ma potrzeby instalowania zewnętrznych narzędzi.

Możesz otworzyć istniejący plik lub po prostu zacząć pisać — nie ma wymogu otwierania pliku najpierw.

Edytor

Lewy panel to pełny edytor kodu CodeMirror, a nie zwykłe pole tekstowe: posiada podświetlanie składni dla pisanego znacznika, pasek narzędzi formatowania (pogrubienie, kursywa, nagłówki, listy i inne, plus dedykowane przyciski do wstawiania linków i obrazów — zobacz Linki i obrazy — oraz do wstawiania tabeli, zobacz Tabele i arkusze kalkulacyjne) oraz wyszukiwanie i zamienianie. Standardowe skróty edycyjne — kopiuj, wklej, cofnij, ponów — działają zgodnie z oczekiwaniami.

Piszesz w jednym z ośmiu lekkich języków znaczników. Są to formaty zwykłego tekstu, które wyrażają strukturę za pomocą interpunkcji (# dla nagłówka, * dla wyróżnienia) zamiast ukrytego stylu, dzięki czemu dokument pozostaje czytelny jako tekst i przyjazny dla różnic w kontroli wersji. Markzen odczytuje wszystkie osiem i decyduje, który język jest używany w pliku na podstawie jego rozszerzenia — nigdy nie wybierasz formatu ręcznie. Kompatybilność wymienia, które rozszerzenia otwierają który język.

Każdy język ma swoje własne konwencje i własny istniejący ekosystem dokumentów; Markzen renderuje każdy w swoim własnym dialekcie, zamiast najpierw konwertować wszystko na Markdown. BBCode jest jedynym, który nie ma jednego standardu — każde forum wymyśliło swój własny wariant — więc Markzen odczytuje go hojnie, akceptując wspólne pisownie obok siebie ([list] lub [ul], [h1] lub [heading=1]) i pozostawiając każdy nierozpoznany tag widoczny jako zwykły tekst, zamiast go pomijać. Aby zmienić rodzaj znacznika, w którym dokument jest napisany, użyj menu Konwertuj do na pasku narzędzi (zobacz Konwertuj i eksportuj poniżej).

Nie każdy język może wyrazić wszystko. Pasek narzędzi formatowania zawiera te same przyciski w każdym dokumencie, ale Markzen zawsze pisze znaczniki, które sam język definiuje — nigdy nie wymyśla prywatnego dialektu, aby zakryć lukę. Przycisk, dla którego bieżący język nie ma notacji, jest wyszarzony. Pogrubienie, kursywa, nagłówki, listy, bloki kodu, linki, obrazy, linie i tabele są dostępne we wszystkich ośmiu; garstka luk jest wymieniona w Kompatybilność. Markdown jest tym, który zaskakuje ludzi: nie ma standardowego sposobu na wyśrodkowanie akapitu, więc Markzen nie oferuje tam przycisków wyrównania, zamiast pisać coś, co tylko niektórzy czytelnicy by honorowali.

Rozmiar tekstu ustawia się za pomocą przycisków Powiększ czcionkę i Zmniejsz czcionkę na pasku narzędzi. Panel edytora można również całkowicie ukryć — wtedy Markzen staje się czystym czytnikiem (zobacz Podgląd na żywo).

Linki i obrazy

Pasek narzędzi formatowania ma dwa dedykowane przyciski do wstawiania linku lub obrazu do dokumentu, a każdy z nich otwiera małe wyskakujące okienko dokładnie tam, gdzie znajduje się kursor. Łącze (Ctrl+K) — lub naciśnij Ctrl+K — wstawia hiperłącze: wpisz tekst linku i jego adres, a Markzen zapisze dla niego prawidłowe znaczniki. Obraz wstawia obraz w ten sam sposób, z kilkoma dodatkowymi opcjami omówionymi poniżej.

Oba są zapisywane w znacznikach używanych przez bieżący dokument — link wstawiony do pliku AsciiDoc pojawi się jako AsciiDoc, do pliku Org jako Org i tak dalej we wszystkich ośmiu językach.

Zaczynając od adresu, który już masz. Wklej adres internetowy do dokumentu, zaznacz go i naciśnij Ctrl+K: Markzen widzi, że zaznaczenie jest adresem, a nie słowami, umieszcza je w polu adresu wyskakującego okienka i pozostawia kursor w pustym polu tekstowym, czekając na to, co link powinien powiedzieć. Bez tego, zaznaczony adres stałby się widocznym tekstem linku — linkiem, który wygląda jak sam adres URL. Bezwzględne ścieżki plików również liczą się jako adresy, w systemie Windows i innych, więc ten sam skrót zamienia wklejoną ścieżkę w link do tego pliku.

Edytowanie istniejącego linku lub obrazu. Umieść kursor w dowolnym miejscu istniejącego linku lub obrazu i ponownie otwórz wyskakujące okienko (przycisk lub Ctrl+K): Markzen rozpoznaje konstrukcję, ładuje jej bieżący tekst i adres do wyskakującego okienka i zastępuje całość po potwierdzeniu — dzięki czemu edytujesz ją na miejscu, zamiast przypadkowo zagnieżdżać nowy link w starym.

W przypadku obrazu, wyskakujące okienko oferuje również przycisk Wyszukaj obraz do wyboru pliku z dysku zamiast wpisywania ścieżki — otwiera się w folderze, z którego ostatnio pobrano obraz, przechowywanym oddzielnie od tego, z którego pochodzą Twoje dokumenty — oraz jedną ważną opcję: czy obraz jest osadzony, czy połączony.

Obrazy osadzone lub połączone

Po wstawieniu obrazu, Markzen może przechowywać go w dokumencie na dwa sposoby:

Połączony — dokument tylko wskazuje na obraz, za pomocą ścieżki pliku lub adresu internetowego. Plik dokumentu pozostaje mały, ale obraz musi podróżować z nim (lub pozostać dostępny pod swoim adresem URL), w przeciwnym razie nie pojawi się nigdzie indziej. Jest to domyślne ustawienie.
Osadzony — rzeczywiste bajty obrazu są zapisywane w dokumencie jako tekst (blok data: base64), więc plik jest całkowicie samodzielny: jeden plik zawiera wszystko, bez ryzyka utraty śledzenia. Kompromisem jest rozmiar — dokument rośnie o wagę obrazu, a osadzony obraz nie może używać ścieżki względnej.

Wybierz Osadzone, gdy chcesz przekazać pojedynczy przenośny plik; wybierz Połączone, gdy przechowujesz obrazy obok dokumentu i chcesz, aby plik pozostał mały.

W przypadku połączonego obrazu pojawia się jeszcze jedna opcja: Ścieżka względna. Gdy obraz znajduje się w folderze dokumentu (lub podfolderze), zaznaczenie tej opcji zapisuje odniesienie jako krótką ścieżkę względną zamiast pełnej ścieżki bezwzględnej, dzięki czemu link działa nadal, gdy przeniesiesz dokument i jego obrazy razem. Jest oferowana tylko wtedy, gdy obraz znajduje się w folderze dokumentu — w przeciwnym razie nie ma ścieżki względnej do zapisania.

Osadzone obrazy pozostają uporządkowane w edytorze. Obraz osadzony w base64 to długa ściana tekstu, która w przeciwnym razie zakopałaby otaczające ją linie, więc Markzen składa każdy z nich w mały chip pokazujący jego typ i rozmiar (na przykład 🖼 webp · 38 KB). Chip jest tylko do wyświetlania — podstawowy tekst pozostaje nietknięty, więc zapisywanie, kopiowanie lub wycinanie zawsze przenosi cały obraz, a kursor przeskakuje przez chip jako pojedynczą jednostkę.

Pliki, karty i zapisywanie

Markzen pozwala na jednoczesne otwieranie dowolnej liczby dokumentów, każdy we własnej karcie, dzięki czemu możesz pracować nad kilkoma plikami i swobodnie się między nimi przełączać. Nie musisz otwierać pliku, aby zacząć — zacznij pisać w pustym dokumencie, który już tam jest, lub użyj przycisków plików na pasku narzędzi:

Nowy dokument — otwiera krótkie menu (Utwórz nowy) z listą ośmiu języków znaczników; wybierz jeden, aby rozpocząć nowy, pusty dokument napisany w tym języku znaczników, w nowej karcie.
Otwórz plik Markdown — przeglądaj w poszukiwaniu istniejącego pliku i otwórz go. Selektor akceptuje wszystkie osiem formatów znaczników, a Markzen wybiera właściwy na podstawie rozszerzenia pliku. Otwiera się w folderze, z którego ostatnio pobrałeś dokument, zapamiętanym między sesjami, więc nie zaczynasz od zera za każdym razem.
Zapisz — zapisuje aktywny dokument z powrotem do jego pliku. Dokument, który nigdy nie został zapisany, przechodzi do opcji Zapisz jako, abyś mógł najpierw nadać mu nazwę.
Zapisz jako — zapisuje aktywny dokument do nowego pliku, pozostawiając oryginalny nietknięty.

Możesz również przeciągnąć plik z menedżera plików i upuścić go na okno, aby go otworzyć.

Każdy otwarty dokument to karta u góry okna. Niezapisana karta jest oznaczona kropką, a karta, której język znaczników nie jest Markdownem, ma małą plakietkę formatu (na przykład adoc). × na karcie zamyka ją — a zamknięcie dokumentu z niezapisanymi zmianami nigdy nie powoduje ich cichego odrzucenia: na karcie pojawia się pasek wbudowany, dzięki czemu możesz najpierw Zapisz lub Odrzuc.

Gdy dokument jest otwarty, Markzen monitoruje jego plik na dysku. Jeśli plik zmieni się w innym programie i nie masz własnych niezapisanych edycji, Markzen automatycznie pobiera nową wersję; jeśli masz niezapisane edycje, pyta najpierw — wbudowany pasek Przeładuj pozwala zdecydować, czy przyjąć wersję na dysku, czy zachować własną.

Podgląd na żywo

Prawy panel to dokument renderowany jako stylizowany HTML, aktualizowany na żywo podczas pisania. Linki działają, tabele są wyrównane, kod jest wyświetlany w bloku o stałej szerokości, listy zadań otrzymują pola wyboru, a każdy blok rozszerzenia renderowania (patrz poniżej) rysuje swoją figurę na miejscu. Podgląd jest wiernym odzwierciedleniem tego, jak będzie wyglądał eksport HTML lub PDF.

Jeśli dokument Markdown otwiera się blokiem YAML front-matter — sekcją --- key: value ---, którą narzędzia takie jak Jekyll, Hugo i Obsidian umieszczają na samym początku — Markzen renderuje go jako schludną kartę metadanych nad dokumentem, zamiast pozwolić, aby zamykające --- zamieniło się w zbłąkany nagłówek.

Tryby układu

Grupa trzech przycisków na pasku narzędzi określa, co wyświetla okno:

Widok podzielony — edytor i podgląd obok siebie. Przeciągnij separator, aby zmienić ilość miejsca, jaką każdy z nich otrzymuje.
Pokaż edytor — sam edytor, wypełniający okno dla pisania bez rozpraszania uwagi.
Pokaż podgląd — sam podgląd, czysty czytnik o pełnej szerokości.

Spis treści

Przycisk Spis treści otwiera panel zbudowany automatycznie ze wszystkich nagłówków w dokumencie (#, ##, ###, …). Kliknij dowolny wpis, aby przewinąć podgląd do tej sekcji. Każdy nagłówek z podnagłówkami poniżej pokazuje szewron: kliknij go, aby Zwiń tę sekcję i ukryć jej zagnieżdżone nagłówki, lub Rozwiń, aby je przywrócić — dzięki czemu możesz zwinąć długi zarys do tylko tych części, nad którymi pracujesz. Małe przyciski 2 / 3 / 4 w nagłówku panelu ograniczają zarys do tej głębokości nagłówka — przydatne w długim dokumencie, gdy chcesz widzieć tylko najwyższe poziomy — a ponowne kliknięcie aktywnego przycisku przywraca wszystkie poziomy. Panel zmienia rozmiar, przeciągając jego lewą krawędź i zwija się, aby zwolnić miejsce do czytania. Jest to pomoc nawigacyjna tylko wewnątrz aplikacji — nigdy nie pojawia się w eksporcie.

Dostarczanie własnego zarysu. Jeśli nagłówki nie są zarysem, którego chcesz, dokument może zawierać własny. Zablokowany blok oznaczony markzen, którego pierwsza linia to toc, zastępuje wygenerowany panel listą napisaną pod nim:

`markdown

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

Wcięcie ustawia poziom, a każdy wpis wskazuje na kotwicę, która musi istnieć w samym dokumencie — nagłówek, któremu nadałeś jawne id, lub zwykły <a id="intro"></a>. Sam blok nic nie rysuje: to metadane, które panel odczytuje.

Tabele i arkusze kalkulacyjne

Tabele czysto przenoszą się między Markzen a dowolnym arkuszem kalkulacyjnym. Wklej tekst rozdzielony tabulatorami — skopiowany z Excela, Arkuszy Google, Worda lub tabeli internetowej — do edytora, a Markzen przekształci go w poprawną tabelę zapisaną w znacznikach dokumentu, zamiast wstawiać ścianę znaków tabulacji. Czytnik wklejania uwzględnia cudzysłowy (poprawnie obsługuje komórki, które same zawierają tabulatory, podziały wierszy lub cudzysłowy) i uruchamia się tylko wtedy, gdy schowek zawiera czystą prostokątną siatkę składającą się z co najmniej dwóch kolumn; wszystko inne wkleja się jako zwykły tekst.

Możesz również zacząć tabelę od zera. Przycisk Wstaw tabelę na pasku narzędzi otwiera małą siatkę — przeciągnij po niej, aby wybrać liczbę wierszy i kolumn, a Markzen zapisze pustą tabelę o tym rozmiarze w znacznikach dokumentu, gotową do wpisywania. Pierwszy wiersz to wiersz nagłówka.

Działa to również w drugą stronę. Najedź kursorem na dowolną wyrenderowaną tabelę w podglądzie, a w jej rogu pojawi się przycisk kopiowania: kopiuje on tabelę z powrotem jako tekst rozdzielony tabulatorami, który można bezpośrednio wkleić do komórki arkusza kalkulacyjnego lub dokumentu Worda. Te przyciski kopiowania służą wyłącznie wygodzie podglądu — są usuwane z każdego eksportu i konwersji, więc udostępniony plik zawiera tylko czystą tabelę.

Rozszerzenia renderowania

Markzen rozszerza standardową składnię Markdown poprzez ogrodzone bloki kodu. Znacznik języka tuż po otwierających potrójnych backtickach decyduje o sposobie renderowania bloku: znacznik, który Markzen rozpoznaje jako rozszerzenie, rysuje figurę na żywo zamiast wyświetlać kod.

Każdy rodzaj figury jest rysowany przez własny silnik renderujący, a Markzen pobiera silnik za pierwszym razem, gdy dokument faktycznie o niego prosi, zamiast ładować je wszystkie przy uruchomieniu — dlatego aplikacja uruchamia się niemal natychmiast, i dlatego pierwszy diagram danego rodzaju może chwilę potrwać, zanim się pojawi, podczas gdy każdy kolejny jest natychmiastowy.

Na przykład, ten kod źródłowy:

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

renderuje się jako dynamiczny schemat blokowy, a nie lista kodu — i pozostaje schematem blokowym również w eksportach PDF i HTML.

Diagramy, wykresy, matematyka, notacja muzyczna, plansze do szachów i Go, kody QR i wiele innych są wbudowane — Kompatybilność wymienia każdy z nich wraz z jego znacznikiem.

Każde rozszerzenie ma swój własny znacznik języka (mermaid, chartjs, katex, abc, chess, …). Możesz mieszać ich dowolną liczbę ze zwykłą prozą w jednym dokumencie — wszystkie renderują się razem. To, czy figura pozostaje figurą po opuszczeniu dokumentu z Markzen, zależy od miejsca, do którego ją wysyłasz — zobacz Konwertuj i eksportuj poniżej.

Formuły w zdaniu

Formuła matematyczna może być blokiem samym w sobie — blokiem katex lub asciimath, stojącym samodzielnie i wyśrodkowanym jak równanie w podręczniku. Działa to we wszystkich ośmiu językach znaczników.

Formuła może również znajdować się w zdaniu, tak aby "pole to pi r kwadrat" czytało się jako jedna linia prozy z prawdziwymi symbolami. Zależy to od języka znaczników, który ma dla niej notację, a każdy z nich zapisuje ją inaczej — notacja dla każdego języka znajduje się w Kompatybilność.

Textile i BBCode to dwa wyjątki, i jest to ograniczenie tych języków, a nie Markzen: żaden z nich nigdy nie zdefiniował sposobu pisania matematyki. W dokumencie Textile lub BBCode formuła musi zatem być osobnym blokiem. Nic nie jest stracone — formuła renderuje się i przetrwa eksport — po prostu nie może być wpleciona w linię prozy.

Umieszczanie i rozmiar figury

Najedź kursorem na wyrenderowaną figurę w podglądzie, a obok niej pojawi się mały panel: przyciski wyrównanie (lewo, środek, prawo) oraz — dla rodzajów figur, które można zmieniać rozmiar — pola szerokość i wysokość w pikselach. remove style block ponownie je czyści.

Ten wybór nie jest przechowywany gdzieś niewidocznie: panel zapisuje go w dokumencie, jako krótki blok oznaczony markzen, umieszczony bezpośrednio przed figurą, do której się odnosi.

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

Układ podróżuje więc z plikiem — jest częścią tego, co zapisujesz, przekazujesz i eksportujesz, na dowolnej maszynie. Równie dobrze możesz napisać blok ręcznie: jedna dyrektywa na linię, align (left, center lub right), width i height w pikselach, zawsze odnosząca się do bloku bezpośrednio pod nią.

Stylizowanie jednego dokumentu za pomocą CSS

Dokument Markdown może również zawierać własny arkusz stylów, w ogrodzonym bloku oznaczonym style:

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

Reguły te mają zastosowanie do podglądu tego dokumentu oraz do jego eksportów PDF i HTML, oprócz aktywnego szablonu stylu — to sposób na nadanie jednemu dokumentowi własnego wyglądu bez zmiany ustawień dla wszystkich innych. Tylko zwykłe selektory: reguły at-rules, takie jak @media i @keyframes, nie są obsługiwane, a blok działa tylko w dokumentach Markdown.

Konwertuj i eksportuj

Menu Konwertuj do na pasku narzędzi to miejsce, w którym gotowy dokument opuszcza Markzen. Wykonuje ono dwie odrębne czynności.

Konwertuj na inny język znaczników. W sekcji Lekkie znaczniki otwórz dokument i przepisz go w jednym z siedmiu innych języków znaczników — AsciiDoc, BBCode, Djot, MediaWiki, Org, reStructuredText lub Textile. Przydatne, gdy wiki wymaga MediaWiki, forum BBCode, wydawca AsciiDoc, lub gdy przenosisz notatki między ekosystemami. Każdy z ośmiu języków pojawia się raz w menu, jako język znaczników: dokument zapisany jako MediaWiki stąd to ten sam plik, który otrzymałbyś gdziekolwiek indziej.

Eksportuj do gotowego formatu. Przekaż dokument do dołączonego konwertera, który generuje ponad dwadzieścia formatów dokumentów, pogrupowanych według ich przeznaczenia:

Kategoria	Formaty
E-booki	EPUB 3, FictionBook2
Edytor tekstu	Microsoft Word (`.docx`), OpenDocument (`.odt`), Rich Text Format (`.rtf`)
Prezentacja	Microsoft PowerPoint (`.pptx`), reveal.js (`.html`)
Skład	InDesign ICML, LaTeX (`.tex`), Typst (`.typ`)
XML	DocBook, JATS, OpenDocument XML, TEI Simple
Notatnik	Jupyter Notebook (`.ipynb`)
Zarys	OPML (`.opml`)

Konwerter jest dostarczany w Markzen — nic dodatkowego do pobrania ani konfiguracji. Obok nich, na pasku narzędzi znajdują się trzy szybkie opcje wyjścia: Zapisz jako PDF i Zapisz jako HTML eksportują renderowany dokument dokładnie tak, jak jest podglądany (wraz z szablonem stylu, czcionkami i figurami rozszerzeń), a Drukuj wysyła go do drukarki. Czcionka kodu jest przesyłana wewnątrz eksportowanego pliku, więc blok kodu lub diagram ASCII wygląda na komputerze czytelnika tak, jak go widziałeś, niezależnie od tego, czy ma zainstalowaną tę czcionkę.

Co jest przesyłane, a co nie. Figura rozszerzenia renderowania pozostaje figurą tylko tam, gdzie format docelowy może zawierać obraz, więc dokument opuszcza Markzen jedną z dwóch dróg:

Jako dokument, który widzisz — trzy wyjścia paska narzędzi właśnie opisane (PDF, HTML, druk) i pięć formatów z powyższej tabeli: EPUB 3, Microsoft Word (.docx), OpenDocument (.odt), Microsoft PowerPoint (.pptx) i Rich Text Format (.rtf). Diagramy, formuły i partytury są zapisywane jako obrazy i docierają nienaruszone.
Jako tekst źródłowy dokumentu — każdy inny cel i każda konwersja na inny język znaczników. Proza, nagłówki, listy, tabele i linki są konwertowane; blok mermaid lub katex dociera jako zwykły blok kodu zawierający wpisany przez Ciebie kod źródłowy, ponieważ te formaty nie mają figury, którą Markzen mógłby im przekazać.

Dlatego dokument zbudowany wokół diagramów najlepiej przekazać jako PDF, HTML, EPUB, Word, OpenDocument, PowerPoint lub RTF. LaTeX, Typst, reveal.js i reszta nadal dają cały dokument — z pozostawionym kodem źródłowym każdej figury, gotowym do użycia przez narzędzia danego ekosystemu.

Eksportowanie z wiersza poleceń

Markzen działa również bez otwierania okna. Przekaż plik wykonywalny Markzen plik źródłowy i -o ze ścieżką wyjściową, a renderuje dokument i zapisuje eksport bezpośrednio na dysk:

markzen.exe report.md -o report.pdf

Źródłem może być dowolny z ośmiu formatów znaczników, które Markzen odczytuje; wyjściem jest plik PDF lub HTML, wybrany przez rozszerzenie nazwy wyjściowej. Eksport przechodzi przez to samo renderowanie, co sama aplikacja, więc diagramy, formuły i każdy inny blok rozszerzeń wychodzą jako żywe figury. Eksporty używają domyślnego szablonu stylu i czcionek — wiersz poleceń działa we własnym czystym profilu, oddzielonym od aplikacji, co oznacza również, że działa dobrze, gdy Markzen jest już otwarty.

Kilka dokumentów można wyeksportować w jednym wywołaniu — podaj dowolną liczbę par źródło -o wyjście, a pojedyncze uruchomienie renderuje je wszystkie, za ułamek kosztów uruchamiania raz na plik:

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

Czcionki i wygląd

Markzen został stworzony, aby dokument wyglądał na złożony, a nie generyczny. Elementy sterujące do tego znajdują się razem na pasku narzędzi za przyciskiem Styl i czcionki, dzięki czemu możesz je dostosować podczas czytania; motyw i język interfejsu znajdują się w Ustawienia → Wyświetlanie.

Szablon stylu

Styl oferuje pięć stylów podglądu: Standardowy, GitHub, Książka, Nowoczesny, Minimalny. Wybrany szablon jest również stylem stosowanym do eksportów PDF i HTML, więc decyduje o tym, jak czyta się udostępniony dokument — wybierz Książka lub Nowoczesny dla czegoś, co przekażesz, Minimalny dla czytania bez rozpraszania uwagi. Szablon stylizuje tylko podgląd, nigdy edytor.

Czcionki

Trzy selektory w tym samym panelu ustawiają osobną czcionkę dla każdego rodzaju tekstu — Nagłówek, Treść i Kod — co sprawia, że dokument Markzen wygląda na złożony:

Nagłówek — Oswald, Playfair Display, Merriweather, Raleway, Montserrat, Lora, Libre Baskerville, Bebas Neue, Abril Fatface, Cinzel.
Treść — Inter, Roboto, Georgia, Lato, Source Serif 4, Nunito, PT Serif, Crimson Text, Libre Franklin, Open Sans.
Kod — JetBrains Mono, Source Code Pro, Cascadia Mono, Fira Mono.

Czcionki kodu są wybrane ze względu na jedną właściwość poza wyglądem: wszystkie rysują znaki rysowania ramek (│ ├ └ ─), z których składają się listy drzew i diagramy ASCII, więc drzewo katalogów wklejone do bloku kodu zachowuje swój kształt zamiast rozpadać się na luki. Są to również warianty bez ligatur — czcionka z ligaturami przerysowuje != jako pojedyncze ≠, co jest przyjemne w edytorze kodu i błędne w dokumencie, który ma pokazać, co faktycznie mówi plik. JetBrains Mono i Source Code Pro są dostarczane z Markzen, więc działają na maszynie, która nigdy ich nie widziała i bez żadnego połączenia.

Rozmiar tekstu

Przyciski Powiększ czcionkę i Zmniejsz czcionkę na pasku narzędzi zmieniają rozmiar tekstu.

Motyw i język

W Ustawienia → Wyświetlanie:

Motyw — Jasny lub Ciemny. Domyślnie: Jasny.
Język — Interfejs Markzen jest przetłumaczony na ponad pięćdziesiąt języków, w tym skrypty pisane od prawej do lewej (arabski, hebrajski) oraz CJK (chiński, japoński, koreański).

Kompatybilność

Tabele referencyjne: co obsługuje każdy język znaczników i każdy rodzaj figur na żywo, które Markzen może rysować. Wszystko tutaj dotyczy co działa gdzie — wyjaśnienia znajdują się w powyższych sekcjach.

Co potrafi każdy język znaczników

Język znaczników	Otwiera pliki kończące się na	Figury na żywo	Panel zawartości	Formuła w zdaniu	Nie może wyrazić
Markdown	`.md`, `.markdown`	wszystkie	tak	$…$	wyrównanie tekstu
AsciiDoc	`.adoc`, `.asciidoc`, `.asc`	wszystkie oprócz `style`	tak	tylko blok	przekreślenie
reStructuredText	`.rst`, `.rest`	wszystkie oprócz `style`	tak	$…$	przekreślenie
Org	`.org`	wszystkie oprócz `style`	tak	$…$	wyrównanie do lewej i prawej
Textile	`.textile`	wszystkie oprócz `style`	tak	tylko blok	—
Djot	`.dj`	wszystkie oprócz `style`	tak	$`…`	—
MediaWiki	`.wiki`, `.mediawiki`, `.wikitext`	wszystkie oprócz `style`	tak	`<math>`	kod w tekście, przekreślenie, cytat blokowy, wyrównanie tekstu
BBCode	`.bbcode`, `.bb`	wszystkie oprócz `style`	tak	tylko blok	—

Figury na żywo — blok style jest jedynym wyjątkiem: stosuje CSS do samego dokumentu, co obsługuje tylko Markdown. Każdy inny rodzaj figury działa w każdym języku. W dokumencie BBCode blok jest zapisywany [code=mermaid]…[/code] zamiast z backtickami; w MediaWiki, <syntaxhighlight lang="mermaid">…</syntaxhighlight>.

Nie może wyrazić — to są ograniczenia samych języków znaczników, a nie Markzen: tam, gdzie język nie ma notacji dla czegoś, Markzen nie oferuje dla tego przycisku, zamiast pisać prywatny dialekt, który tylko on mógłby odczytać. Zobacz Formuły wewnątrz zdania dla wiersza matematyki.

Każdy rodzaj figury

Napisz tag po otwierających potrójnych backtickach — ```mermaid — a blok stanie się figurą.

Kategoria	Figura	Tag bloku	Uwagi
Diagramy	Mermaid	`mermaid`	schematy blokowe, sekwencyjne, klas, Gantta, ER, stanów
	Graphviz	`graphviz`	język DOT
	Cytoscape	`cytoscape`	wykresy sieciowe; przesuwanie i powiększanie w podglądzie
	Markmap	`markmap`	mapa myśli z listy punktowanej; kliknij, aby zwinąć
	Timeline	`timeline`	pionowa oś czasu wydarzeń
Diagramy oprogramowania	Nomnoml	`nomnoml`	UML
	PlantUML	`plantuml`	UML — jedyna figura wymagająca połączenia z internetem
	DBML	`dbml`	diagramy schematów baz danych
Wykresy	Chart.js	`chartjs`	słupkowe, liniowe, kołowe, radarowe
	Vega-Lite	`vega-lite`	deklaratywne wykresy z JSON
	ECharts	`echarts`	duże interaktywne wykresy
Rozwój IT	Pseudocode	`pseudocode`	algorytmy składane
	Tabulator	`tabulator`	sortowalna interaktywna tabela
	Bytefield	`bytefield`	układy pól bitowych i bajtowych
	QR Code	`qrcode`
	Railroad	`railroad`	diagramy składni
	WaveDrom	`wavedrom`	cyfrowe diagramy czasowe
Matematyka	KaTeX	`katex`	również $…$ w zdaniu — zobacz tabelę powyżej
	AsciiMath	`asciimath`	notacja matematyczna w postaci zwykłego tekstu
Wykresy	function-plot	`fnplot`	rysuje krzywą funkcji
	JSXGraph	`jsxgraph`	interaktywna geometria
	Plotly	`plotly`	wykresy naukowe i 3D
Nauki ścisłe	SMILES	`smiles`	diagramy struktur chemicznych
Muzyka	ABC Notation	`abc`	nuty z tekstu
	VexFlow	`vexflow`	grawerowane pięciolinie
	VexChords	`vexchords`	diagramy akordów gitarowych
	ChordPro	`chordpro`	akordy nad tekstem
	MusicXML	`musicxml`	pełne partytury
Gry	Chess	`chess`	plansza z pozycji FEN
	Go Board	`goboard`	9×9, 13×13 i 19×19
Dokument	Markzen	`markzen`	niewidoczny: umieszcza i skaluje figurę poniżej, lub nadpisuje panel zawartości
	Style	`style`	niewidoczny: CSS dla tego dokumentu — tylko Markdown

Skojarzenia plików

W systemie Windows instalator może zarejestrować Markzen jako program obsługujący każdy typ pliku znaczników, który odczytuje — wszystkie piętnaście rozszerzeń wymienionych w Zgodność, we wszystkich ośmiu językach. Po zarejestrowaniu, dwukrotne kliknięcie jednego z tych plików w Eksploratorze otwiera go bezpośrednio w Markzen, a jeśli zainstalowano kilka edytorów, nadal możesz wybrać Markzen za pomocą opcji „Otwórz za pomocą…”.

Skróty klawiaturowe

Klawisz	Akcja
`Ctrl+S`	Zapisz
`Ctrl+Shift+S`	Zapisz jako
`Ctrl+ +` / `Ctrl+ -`	Zwiększ / zmniejsz rozmiar tekstu

Standardowe skróty edytora — znajdź, zamień, kopiuj, wklej, cofnij, ponów — oraz skróty paska narzędzi formatowania (pogrubienie Ctrl+B, kursywa Ctrl+I, nagłówek Ctrl+H, link Ctrl+K i inne) działają w panelu edytora. Skrót formatowania istnieje tylko tam, gdzie bieżący znacznik ma konstrukcję — Ctrl+D nic nie robi w dokumencie AsciiDoc, który nie ma własnego przekreślenia (zobacz Edytor).

Wskazówki

Ukryj edytor, aby czytać. Pojedynczy widok z podglądem zmienia Markzen w czysty czytnik, a pięć szablonów stylów pozwala ustawić jego wygląd.
Jeden dokument, każdy rodzaj treści. Schemat blokowy Mermaid, równanie KaTeX i partytura muzyczna mogą znajdować się obok zwykłej prozy — wszystkie renderują się razem i wszystkie przetrwają eksport do PDF i HTML.
Szablon stylu to wygląd eksportu. Niezależnie od wybranego szablonu, jest to styl wbudowany w wyjście PDF i HTML, więc ustaw go przed eksportem.
Pisz w znacznikach, które lubisz, dostarczaj w formacie, którego potrzebują. Twórz w Markdown (lub dowolnym z ośmiu), a następnie użyj opcji Konwertuj na plik Worda, prezentację, ebooka lub źródło LaTeX — nie są wymagane żadne oddzielne narzędzia.