Довідка
Що таке Markzen?
Markzen — це настільний редактор для легких мов розмітки — Markdown та шести інших — з живим, повністю стилізованим попереднім переглядом. Ви пишете звичайний текст, розмічений простою пунктуацією, ліворуч, а Markzen відображає його як відформатований HTML праворуч під час введення.
Що відрізняє його від звичайного редактора Markdown, так це зворотний шлях. Markzen читає вісім мов розмітки, відображає 30 живих розширень (діаграми, графіки, математичні формули, ноти, шахові дошки, QR-коди) всередині документа та експортує у понад двадцять форматів — електронні книги, Word, PowerPoint, LaTeX, блокноти Jupyter та багато іншого. Напишіть один раз, а результат передайте майже в будь-якому форматі. Конвертер вбудований, тому не потрібно встановлювати зовнішні інструменти.
Ви можете відкрити існуючий файл або просто почати друкувати — немає вимоги спочатку відкривати файл.
Редактор
Ліва панель — це повноцінний редактор коду CodeMirror, а не звичайне текстове поле: він має підсвічування синтаксису для розмітки, яку ви пишете, панель інструментів форматування (жирний, курсив, заголовки, списки та інше, а також спеціальні кнопки для вставки посилань та зображень — див. Посилання та зображення — та для вставки таблиці, див. Таблиці та електронні таблиці), а також пошук із заміною. Стандартні комбінації клавіш для редагування — копіювати, вставити, скасувати, повторити — працюють, як ви очікуєте.
Ви пишете однією з восьми легких мов розмітки. Це формати звичайного тексту, які виражають структуру за допомогою пунктуації (# для заголовка, * для виділення) замість прихованого стилю, тому документ залишається читабельним як текст і зручним для порівняння у системі контролю версій. Markzen читає всі вісім і визначає, якою мовою є файл, за його розширенням — ви ніколи не вибираєте формат вручну. Сумісність перераховує, які розширення відкривають яку мову.
Кожна мова має свої власні конвенції та власну існуючу екосистему документів; Markzen відтворює кожну у власному діалекті, а не конвертує все спочатку в Markdown. BBCode — це єдина мова без єдиного стандарту — кожен форум винайшов свій власний варіант — тому Markzen читає її щедро, приймаючи загальні написання поруч ([list] або [ul], [h1] або [heading=1]) і залишаючи будь-який тег, який він не розпізнає, видимим як звичайний текст, а не поглинаючи його. Щоб змінити тип розмітки, якою написаний документ, використовуйте меню Конвертувати в на панелі інструментів (див. Конвертувати та експортувати нижче).
Не кожна мова може виразити все. Панель інструментів форматування має однакові кнопки в кожному документі, але Markzen завжди пише розмітку, яку визначає сама мова — вона ніколи не винаходить приватний діалект, щоб заповнити прогалину. Кнопка, для якої поточна мова не має позначення, виділена сірим кольором. Жирний, курсив, заголовки, списки, блоки коду, посилання, зображення, правила та таблиці доступні у всіх восьми; кілька прогалин перераховані в Сумісність. Markdown дивує людей: він не має стандартного способу центрування абзацу, тому Markzen не пропонує кнопок вирівнювання, а не пише щось, що лише деякі читачі поважали б.
Розмір тексту встановлюється кнопками Збільшити шрифт та Зменшити шрифт на панелі інструментів. Панель редактора також може бути повністю прихована — тоді Markzen стає чистим засобом для читання (див. Попередній перегляд у реальному часі).
Посилання та зображення
Панель форматування має дві спеціальні кнопки для вставки посилання або зображення в документ, і кожна з них відкриває невелике спливаюче вікно прямо там, де знаходиться ваш курсор. Посилання (Ctrl+K) — або натисніть Ctrl+K — вставляє гіперпосилання: введіть текст посилання та його адресу, і Markzen напише для нього правильну розмітку. Зображення вставляє зображення таким же чином, з кількома додатковими опціями, розглянутими нижче.
Обидва записуються в розмітці, яку використовує поточний документ — посилання, вставлене в файл AsciiDoc, виглядає як AsciiDoc, у файл Org — як Org, і так далі для всіх восьми мов.
Починаючи з адреси, яку ви вже маєте. Вставте веб-адресу в документ, виділіть її та натисніть Ctrl+K: Markzen бачить, що виділення є адресою, а не словами, поміщає її в поле адреси спливаючого вікна та залишає курсор у порожньому текстовому полі, чекаючи, що має сказати посилання. Без цього виділена адреса стала б видимим текстом посилання — посиланням, яке читається як чиста URL-адреса. Абсолютні шляхи до файлів також вважаються адресами, на Windows та інших платформах, тому той самий ярлик перетворює вставлений шлях на посилання до цього файлу.
Редагування вже існуючого посилання або зображення. Помістіть курсор у будь-яке місце існуючого посилання або зображення та знову відкрийте спливаюче вікно (кнопка або Ctrl+K): Markzen розпізнає конструкцію, завантажує її поточний текст та адресу у спливаюче вікно та замінює все це, коли ви підтверджуєте — таким чином ви редагуєте його на місці, замість того, щоб випадково вкладати нове посилання всередину старого.
Для зображення спливаюче вікно також пропонує кнопку Знайти зображення для вибору файлу з диска замість введення шляху — воно відкривається в папці, з якої ви востаннє брали зображення, що зберігається окремо від тієї, з якої походять ваші документи — та один важливий вибір: чи є зображення вбудованим чи пов'язаним.
Вбудовані або пов'язані зображення
Коли ви вставляєте зображення, Markzen може зберігати його в документі двома способами:
- Зв'язаний — документ лише вказує на зображення за допомогою шляху до файлу або веб-адреси. Файл документа залишається невеликим, але зображення має подорожувати з ним (або залишатися доступним за його URL-адресою), інакше воно не відображатиметься в іншому місці. Це типовий варіант.
- Вбудований — фактичні байти зображення записуються в документ як текст (блок
data:base64), тому файл повністю самодостатній: один файл містить усе, нічого не втрачаючи. Компроміс — розмір: документ збільшується на вагу зображення, а вбудоване зображення не може використовувати відносний шлях.
Виберіть Вбудоване, коли вам потрібен один портативний файл для передачі; виберіть Пов'язане, коли ви зберігаєте зображення поруч із документом і хочете, щоб файл залишався невеликим.
Для пов'язаного зображення з'являється ще одна опція: Відносний шлях. Коли зображення знаходиться у власній папці документа (або підпапці), встановлення цього прапорця записує посилання як короткий відносний шлях замість повного абсолютного, тому посилання продовжує працювати, коли ви переміщуєте документ та його зображення разом. Ця опція пропонується лише тоді, коли зображення знаходиться всередині папки документа — інакше немає відносного шляху для запису.
Вбудовані зображення залишаються охайними в редакторі. Вбудоване зображення base64 — це довга стіна тексту, яка інакше поховала б рядки навколо нього, тому Markzen згортає кожне з них у невеликий чіп, що показує його тип і розмір (наприклад, 🖼 webp · 38 KB). Чіп призначений лише для відображення — базовий текст залишається недоторканим, тому збереження, копіювання або вирізання завжди переносить повне зображення, а курсор пропускає чіп як єдиний елемент.
Файли, вкладки та збереження
Markzen дозволяє тримати відкритою будь-яку кількість документів одночасно, кожен у своїй вкладці, щоб ви могли працювати з кількома файлами та вільно перемикатися між ними. Вам не потрібно відкривати файл, щоб почати — просто почніть друкувати в порожньому документі, який вже є, або скористайтеся кнопками файлів на панелі інструментів:
- Новий документ — відкриває коротке меню (Створити новий) зі списком восьми мов розмітки; виберіть одну, щоб розпочати новий, порожній документ, написаний цією розміткою, у новій вкладці.
- Відкрити файл Markdown — переглянути наявний файл і відкрити його. Засіб вибору приймає всі вісім форматів розмітки, і Markzen вибирає правильний за розширенням файлу. Він відкривається в папці, з якої ви востаннє брали документ, запам'ятовується між сеансами, тому вам не доведеться починати з нуля щоразу.
- Зберегти — записати активний документ назад у його файл. Документ, який ніколи не зберігався, переходить до функції «Зберегти як», щоб ви могли спочатку назвати його.
- Зберегти як — зберегти активний документ у новий файл, залишивши оригінал недоторканим.
Ви також можете перетягнути файл з файлового менеджера та скинути його у вікно, щоб відкрити.
Кожен відкритий документ є вкладкою у верхній частині вікна. Незбережена вкладка позначається крапкою, а вкладка, розмітка якої не є Markdown, має невеликий значок формату (наприклад, adoc). × на вкладці закриває її — і закриття документа з незбереженими змінами ніколи не відкидає їх мовчки: на вкладці з'являється вбудована панель, щоб ви могли спочатку Зберегти або Скасувати.
Поки документ відкрито, Markzen відстежує його файл на диску. Якщо файл змінюється в іншій програмі, і у вас немає власних незбережених змін, Markzen автоматично завантажує нову версію; якщо у вас є незбережені зміни, він спочатку запитує — вбудована панель Оновити дозволяє вам вирішити, чи прийняти версію на диску, чи зберегти свою власну.
Попередній перегляд у реальному часі
Права панель — це документ, відтворений як стилізований HTML, що оновлюється в реальному часі під час введення тексту. Посилання працюють, таблиці вирівнюються, код відображається в моноширинному блоці, списки завдань отримують прапорці, і кожен блок розширення рендерингу (див. нижче) малює свою фігуру на місці. Попередній перегляд є точним відображенням того, як виглядатиме експорт HTML або PDF.
Якщо документ Markdown відкривається з блоком YAML front-matter — розділом --- key: value ---, який такі інструменти, як Jekyll, Hugo та Obsidian, розміщують на самому верху — Markzen відтворює його як акуратну картку метаданих над документом, замість того, щоб дозволяти кінцевому --- перетворюватися на випадковий заголовок.
Режими макета
Група з трьох кнопок на панелі інструментів визначає, що відображається у вікні:
- Розділений вид — редактор і попередній перегляд поруч. Перетягніть роздільник, щоб змінити обсяг простору, який отримує кожен.
- Показати редактор — лише редактор, що заповнює вікно для написання без відволікань.
- Показати попередній перегляд — лише попередній перегляд, чистий читач на всю ширину.
Зміст
Кнопка Зміст відкриває панель, яка автоматично створюється з кожного заголовка в документі (#, ##, ###, …). Клацніть будь-який запис, щоб прокрутити попередній перегляд до цього розділу. Будь-який заголовок з підзаголовками під ним показує шеврон: клацніть його, щоб Згорнути цей розділ і приховати його вкладені заголовки, або Розгорнути, щоб повернути їх — таким чином ви можете згорнути довгий контур до тих частин, над якими ви працюєте. Маленькі кнопки 2 / 3 / 4 у заголовку панелі обмежують контур до цієї глибини заголовка — корисно в довгому документі, коли ви хочете бачити лише верхні рівні — і повторне натискання активної кнопки повертає кожен рівень. Панель змінює розмір, перетягуючи її лівий край, і згортається, щоб звільнити місце для читання. Це засіб навігації лише всередині програми — він ніколи не з'являється в експорті.
Надання власного контуру. Якщо заголовки не є бажаним контуром, документ може містити свій власний. Блок з огорожею, позначений markzen, перший рядок якого toc, замінює згенеровану панель списком, написаним під ним:
`markdown
```markzen
toc
- [Introduction](#intro)
- [Background](#background)
- [Results](#results)
```
Відступ встановлює рівень, і кожен запис вказує на якір, який повинен існувати в самому документі — заголовок, якому ви дали явний id, або простий <a id="intro"></a>. Сам блок нічого не малює: це метадані, які читає панель.
Таблиці та електронні таблиці
Таблиці легко переміщуються між Markzen та будь-якою електронною таблицею. Вставте текст, розділений табуляцією — скопійований з Excel, Google Sheets, Word або веб-таблиці — в редактор, і Markzen перетворить його на належну таблицю, написану власною розміткою документа, замість того, щоб вставляти стіну символів табуляції. Зчитувач вставки враховує лапки (він правильно обробляє клітинки, які самі містять табуляції, розриви рядків або лапки) і спрацьовує лише тоді, коли буфер обміну містить чисту прямокутну сітку принаймні з двох стовпців; все інше вставляється як звичайний текст.
Ви також можете створити таблицю з нуля. Кнопка Вставити таблицю на панелі інструментів відкриває невелику сітку — проведіть по ній, щоб вибрати потрібну кількість рядків і стовпців, і Markzen напише порожню таблицю такого розміру у власній розмітці документа, готову для введення. Перший рядок є рядком заголовка.
Працює і зворотний процес. Наведіть курсор на будь-яку відтворену таблицю в попередньому перегляді, і в її кутку з'явиться кнопка копіювання: вона копіює таблицю назад як текст, розділений табуляцією, який можна вставити безпосередньо в клітинку електронної таблиці або документ Word. Ці кнопки копіювання призначені лише для зручності попереднього перегляду — вони видаляються з кожного експорту та перетворення, тому спільний файл містить лише чисту таблицю.
Розширення рендерингу
Markzen розширює стандартну розмітку за допомогою огороджених блоків коду. Тег мови одразу після початкових потрійних зворотних апострофів визначає, як блок рендериться: тег, який Markzen розпізнає як розширення, малює живу фігуру замість показу коду.
Кожен тип фігури малюється власним механізмом рендерингу, і Markzen отримує механізм вперше, коли документ фактично його запитує, а не завантажує їх усі при запуску — ось чому програма запускається майже миттєво, і чому перша діаграма певного типу може зайняти деякий час, щоб з'явитися, тоді як кожна наступна з'являється миттєво.
Наприклад, цей вихідний код:
```mermaid
graph LR
A --> B --> C
```
рендериться як жива блок-схема, а не список коду — і вона залишається блок-схемою також у експортах PDF та HTML.
Діаграми, графіки, математика, ноти, шахові та го-дошки, QR-коди та багато іншого вбудовано — Сумісність перераховує кожен з них з його тегом.
Кожне розширення має свій власний мовний тег (mermaid, chartjs, katex, abc, chess, …). Ви можете змішувати стільки, скільки забажаєте, зі звичайною прозою в одному документі — усі вони рендеряться разом. Чи залишається фігура фігурою після того, як документ залишає Markzen, залежить від того, куди ви його надсилаєте — дивіться Конвертувати та експортувати нижче.
Формули всередині речення
Математична формула може бути власним блоком — блоком katex або asciimath, що стоїть окремо
та центрований, як рівняння в підручнику. Це працює в усіх восьми мовах розмітки.
Формула також може знаходитися всередині речення, так що "площа дорівнює пі ер квадрат" читається як один рядок прози з реальними символами. Це залежить від того, чи має мова розмітки для цього позначення, і кожна з них пише його по-різному — позначення для кожної мови знаходиться в Сумісність.
Textile та BBCode є двома винятками, і це обмеження цих мов, а не Markzen: жодна з них ніколи не визначала спосіб написання математики. У документі Textile або BBCode формула тому повинна бути власним блоком. Нічого не втрачається — формула рендериться, і вона виживає при експорті — її просто не можна вплести в рядок прози.
Розміщення та розмір фігури
Наведіть курсор на відрендерену фігуру в попередньому перегляді, і поруч з'явиться невелика панель: кнопки вирівнювання (ліворуч, по центру, праворуч) та — для типів фігур, які можна змінювати розмір — поля ширина та висота у пікселях. remove style block знову їх очищає.
Цей вибір не зберігається десь невидимо: панель записує його в документ як короткий блок з тегом markzen, розміщений безпосередньо перед фігурою, до якої він застосовується.
```markzen
style
align center
width 480
```
Таким чином, макет подорожує з файлом — це частина того, що ви зберігаєте, передаєте та експортуєте на будь-якій машині. Ви також можете написати блок вручну: одна директива на рядок, align (left, center або right), width та height у пікселях, завжди застосовуючись до блоку безпосередньо під ним.
Стилізація одного документа за допомогою CSS
Документ Markdown також може містити власний аркуш стилів у огородженому блоці з тегом style:
```style
h2 { color: #b03030; border-bottom: 2px solid #b03030; }
blockquote { font-style: italic; }
```
Правила застосовуються до попереднього перегляду цього документа та до його експортів PDF та HTML, на додаток до будь-якого активного шаблону стилів — спосіб надати одному документу власний вигляд, не змінюючи налаштування для всього іншого. Лише звичайні селектори: правила @media та @keyframes не підтримуються, і блок працює лише в документах Markdown.
Конвертувати та експортувати
Меню Конвертувати в на панелі інструментів — це місце, де готовий документ залишає Markzen. Воно виконує дві різні функції.
Конвертувати в іншу мову розмітки. У розділі Легка розмітка перепишіть відкритий документ як будь-яку з семи інших мов розмітки — AsciiDoc, BBCode, Djot, MediaWiki, Org, reStructuredText або Textile. Корисно, коли вікі потрібна MediaWiki, форуму потрібен BBCode, видавцю потрібен AsciiDoc, або ви переміщуєте нотатки між екосистемами. Кожна з восьми з'являється в меню один раз, як мова розмітки: документ, збережений як MediaWiki звідси, є тим самим файлом, який ви отримали б деінде.
Експортувати в готовий формат. Передайте документ вбудованому конвертеру, який видає понад двадцять форматів документів, згрупованих за їх призначенням:
| Категорія | Формати |
|---|---|
| Електронні книги | EPUB 3, FictionBook2 |
| Текстовий процесор | Microsoft Word (.docx), OpenDocument (.odt), Rich Text Format (.rtf) |
| Презентація | Microsoft PowerPoint (.pptx), reveal.js (.html) |
| Набір тексту | InDesign ICML, LaTeX (.tex), Typst (.typ) |
| XML | DocBook, JATS, OpenDocument XML, TEI Simple |
| Блокнот | Jupyter Notebook (.ipynb) |
| Конспект | OPML (.opml) |
Конвертер постачається всередині Markzen — нічого додаткового завантажувати чи налаштовувати не потрібно. Поряд з ними на панелі інструментів розташовані три швидкі виводи: Зберегти як PDF та Зберегти як HTML експортують відрендерений документ точно так, як він відображається в попередньому перегляді (включно зі стильовим шаблоном, шрифтами та розширеними фігурами), а Друк надсилає його на принтер. Шрифти коду передаються всередині експортованого файлу, тому блок коду або ASCII-діаграма відображаються на комп'ютері читача так, як ви їх бачили, незалежно від того, чи встановлений у них цей шрифт.
Що передається, а що ні. Фігура розширення рендерингу залишається фігурою лише там, де цільовий формат може містити зображення, тому документ залишає Markzen одним із двох шляхів:
- Як документ, який ви бачите — три виводи панелі інструментів, щойно описані (PDF, HTML, друк), та п'ять форматів з таблиці вище: EPUB 3, Microsoft Word (
.docx), OpenDocument (.odt), Microsoft PowerPoint (.pptx) та Rich Text Format (.rtf). Діаграми, формули та ноти записуються як зображення та надходять без змін. - Як вихідний текст документа — усі інші цілі та кожне перетворення в іншу мову розмітки. Проза, заголовки, списки, таблиці та посилання конвертуються; блок
mermaidабоkatexнадходить як звичайний блок коду, що містить вихідний код, який ви набрали, оскільки ці формати не мають фігури, яку Markzen міг би їм передати.
Отже, документ, побудований навколо діаграм, найкраще передавати як PDF, HTML, EPUB, Word, OpenDocument, PowerPoint або RTF. LaTeX, Typst, reveal.js та інші все ще надають вам весь документ — з вихідним кодом кожної фігури, готовим для власних інструментів цієї екосистеми.
Експорт з командного рядка
Markzen також працює без відкриття вікна. Передайте виконуваному файлу Markzen вихідний файл та -o зі шляхом виведення, і він відрендерить документ та запише експорт безпосередньо на диск:
markzen.exe report.md -o report.pdf
Джерелом може бути будь-який з восьми форматів розмітки, які читає Markzen; вихідним файлом є PDF або HTML файл, обраний за розширенням вихідного імені. Експорт проходить через той самий рендеринг, що й сама програма, тому діаграми, формули та всі інші блоки розширень виходять як живі фігури. Експорт використовує шаблон стилю та шрифти за замовчуванням — командний рядок працює у власному чистому профілі, окремо від програми, що також означає, що він чудово працює, поки Markzen вже відкрито.
Кілька документів можна експортувати за один виклик — надайте будь-яку кількість пар source -o output, і один запуск відрендерить їх усі, за частку вартості запуску один раз для кожного файлу:
markzen.exe a.md -o a.pdf b.adoc -o b.html c.rst -o c.pdf
Шрифти та вигляд
Markzen створено для того, щоб документ виглядав набраним, а не типовим. Елементи керування для цього знаходяться на панелі інструментів за кнопкою Стиль і шрифти, тому ви можете налаштовувати їх під час читання; тема та мова інтерфейсу знаходяться в Налаштуваннях → Відображення.
Шаблон стилю
Стиль пропонує п'ять стилів попереднього перегляду: Стандартний, GitHub, Книга, Сучасний, Мінімальний. Обраний вами шаблон також є стилем, що застосовується до експорту в PDF та HTML, тому він визначає, як читається спільний документ — оберіть Книга або Сучасний для того, що ви передаватимете, Мінімальний для читання без відволікань. Шаблон стилізує лише попередній перегляд, ніколи не редактор.
Шрифти
Три вибірники на одній панелі встановлюють окремий шрифт для кожного типу тексту — Заголовок, Основний текст та Код — що робить документ Markzen схожим на набраний:
- Заголовки — Oswald, Playfair Display, Merriweather, Raleway, Montserrat, Lora, Libre Baskerville, Bebas Neue, Abril Fatface, Cinzel.
- Основний текст — Inter, Roboto, Georgia, Lato, Source Serif 4, Nunito, PT Serif, Crimson Text, Libre Franklin, Open Sans.
- Код — JetBrains Mono, Source Code Pro, Cascadia Mono, Fira Mono.
Шрифти для коду обрані за однією властивістю, крім зовнішнього вигляду: всі вони малюють символи для малювання рамок (│ ├ └ ─), з яких складаються списки дерев та ASCII-діаграми, тому дерево каталогів, вставлене в блок коду, зберігає свою форму замість того, щоб розбиватися на прогалини. Вони також є варіантами без лігатур — шрифт з лігатурами перемальовує != як єдиний ≠, що приємно в редакторі коду і неправильно в документі, який має показувати, що насправді написано у файлі. JetBrains Mono та Source Code Pro постачаються разом з Markzen, тому вони працюють на машині, яка ніколи їх не бачила, і без будь-якого підключення.
Розмір тексту
Кнопки Збільшити шрифт та Зменшити шрифт на панелі інструментів змінюють розмір тексту.
Тема та мова
У Налаштуваннях → Відображення:
- Тема — Світла або Темна. За замовчуванням: Світла.
- Мова — власний інтерфейс Markzen перекладено більш ніж на п'ятдесят мов, включаючи письмові системи з письмом справа наліво (арабська, іврит) та CJK (китайська, японська, корейська).
Сумісність
Довідкові таблиці: що підтримує кожна мова розмітки та кожен тип живих фігур, які може малювати Markzen. Усе тут стосується того, що де працює — пояснення знаходяться в розділах вище.
Що може робити кожна мова розмітки
| Мова розмітки | Відкриває файли з розширенням | Живі фігури | Панель вмісту | Формула в реченні | Не може виразити |
|---|---|---|---|---|---|
| Markdown | .md, .markdown |
усі | так | $…$ |
вирівнювання тексту |
| AsciiDoc | .adoc, .asciidoc, .asc |
усі, крім style |
так | лише блок | закреслення |
| reStructuredText | .rst, .rest |
усі, крім style |
так | $…$ |
закреслення |
| Org | .org |
усі, крім style |
так | $…$ |
вирівнювання ліворуч і праворуч |
| Textile | .textile |
усі, крім style |
так | лише блок | — |
| Djot | .dj |
усі, крім style |
так | $`…` |
— |
| MediaWiki | .wiki, .mediawiki, .wikitext |
усі, крім style |
так | <math> |
вбудований код, закреслення, цитата, вирівнювання тексту |
| BBCode | .bbcode, .bb |
усі, крім style |
так | лише блок | — |
Живі фігури — блок style є єдиним винятком: він застосовує CSS до самого документа, що підтримує лише Markdown. Усі інші типи фігур працюють у будь-якій мові. У документі BBCode блок пишеться [code=mermaid]…[/code], а не з зворотними апострофами; у MediaWiki — <syntaxhighlight lang="mermaid">…</syntaxhighlight>.
Не може виразити — це обмеження самих мов розмітки, а не Markzen: якщо мова не має позначення для чогось, Markzen не пропонує для цього кнопки, замість того, щоб писати приватний діалект, який лише вона могла б прочитати. Дивіться Формули всередині речення для рядка математики.
Кожен тип фігури
Напишіть тег після відкриття трьох зворотних апострофів — ```mermaid — і блок стане фігурою.
| Категорія | Фігура | Тег блоку | Примітки |
|---|---|---|---|
| Діаграми | Mermaid | mermaid |
блок-схеми, послідовності, класи, Ганта, ER, стани |
| Graphviz | graphviz |
мова DOT | |
| Cytoscape | cytoscape |
мережеві графіки; панорамування та масштабування в попередньому перегляді | |
| Markmap | markmap |
ментальна карта з маркованого списку; натисніть, щоб згорнути | |
| Timeline | timeline |
вертикальна часова шкала подій | |
| Діаграми програмного забезпечення | Nomnoml | nomnoml |
UML |
| PlantUML | plantuml |
UML — єдина фігура, яка потребує підключення до Інтернету | |
| DBML | dbml |
діаграми схем баз даних | |
| Діаграми | Chart.js | chartjs |
стовпчасті, лінійні, кругові, радіальні |
| Vega-Lite | vega-lite |
декларативні діаграми з JSON | |
| ECharts | echarts |
великі інтерактивні діаграми | |
| ІТ-розробка | Pseudocode | pseudocode |
набір алгоритмів |
| Tabulator | tabulator |
сортувальна інтерактивна таблиця | |
| Bytefield | bytefield |
макети бітових і байтових полів | |
| QR Code | qrcode |
||
| Railroad | railroad |
синтаксичні діаграми | |
| WaveDrom | wavedrom |
діаграми цифрових таймінгів | |
| Математика | KaTeX | katex |
також $…$ у реченні — дивіться таблицю вище |
| AsciiMath | asciimath |
математична нотація у вигляді простого тексту | |
| Графіки | function-plot | fnplot |
побудова кривої функції |
| JSXGraph | jsxgraph |
інтерактивна геометрія | |
| Plotly | plotly |
наукові та 3-D діаграми | |
| Науки | SMILES | smiles |
діаграми хімічних структур |
| Музика | ABC Notation | abc |
ноти з простого тексту |
| VexFlow | vexflow |
гравіровані нотні стани | |
| VexChords | vexchords |
діаграми гітарних акордів | |
| ChordPro | chordpro |
акорди над текстом пісні | |
| MusicXML | musicxml |
повні партитури | |
| Ігри | Chess | chess |
дошка з позиції FEN |
| Go Board | goboard |
9×9, 13×13 та 19×19 | |
| Документ | Markzen | markzen |
невидимий: розміщує та масштабує фігуру під ним або перевизначає панель вмісту |
| Style | style |
невидимий: CSS для цього документа — лише Markdown |
Асоціації файлів
У Windows інсталятор може зареєструвати Markzen як обробник для кожного типу файлів розмітки, які він читає — усі п'ятнадцять розширень, перелічених у Сумісність, для всіх восьми мов. Після реєстрації подвійне клацання одного з цих файлів у Провіднику відкриває його безпосередньо в Markzen, і якщо встановлено кілька редакторів, ви все ще можете вибрати Markzen через "Відкрити за допомогою…".
Комбінації клавіш
| Клавіша | Дія |
|---|---|
Ctrl+S |
Зберегти |
Ctrl+Shift+S |
Зберегти як |
Ctrl+ + / Ctrl+ - |
Збільшити / зменшити розмір тексту |
Стандартні комбінації клавіш редактора — знайти, замінити, копіювати, вставити, скасувати, повторити — та комбінації клавіш панелі форматування (жирний Ctrl+B, курсив Ctrl+I, заголовок Ctrl+H, посилання Ctrl+K тощо) працюють у панелі редактора. Комбінація клавіш форматування існує лише там, де поточна розмітка має відповідну конструкцію — Ctrl+D нічого не робить у документі AsciiDoc, який не має власного закреслення (див. Редактор).
Поради
- Приховати редактор для читання. Одиночний перегляд з відображенням попереднього перегляду перетворює Markzen на чистий зчитувач, а п'ять шаблонів стилів дозволяють налаштувати його вигляд.
- Один документ, будь-який тип вмісту. Блок-схема Mermaid, рівняння KaTeX та нотний запис можуть розташовуватися поруч зі звичайним текстом — усі вони відтворюються разом і всі зберігаються при експорті в PDF та HTML.
- Шаблон стилю — це вигляд експорту. Який би шаблон ви не вибрали, це стиль, вбудований у вихідний файл PDF та HTML, тому встановіть його перед експортом.
- Пишіть у розмітці, яка вам подобається, надавайте у форматі, який їм потрібен. Створюйте чернетку в Markdown (або будь-якій з восьми), потім використовуйте Convert to для файлу Word, слайд-шоу, електронної книги або джерела LaTeX — окремі інструменти не потрібні.