Markdown і HTML у переглядачі

Натисніть F3 на файлі .md або .html, і він з'явиться відформатованим, а не як вихідний текст: заголовки, списки, таблиці, посилання, списки завдань і блоки коду, розфарбовані за мовою. Діаграми, записані блоком ```mermaid, малюються, а математика між знаками долара набирається.

Це плагін. Усе на цій сторінці забезпечує Markdown and HTML, який можна вимкнути в Конфігурація ▸ Плагіни… — нижче описано, що тоді змінюється.

Де з'являється відформатований вигляд

• Переглядач (F3). Відформатована сторінка. Меню Вигляд досі пропонує Текст, Код і Hex, тож вихідний текст за один клік, і назва плагіна теж є в цьому списку.
• Quick View (Ctrl+Q) та інформаційна сторінка бічної панелі показують те саме, тож попередній перегляд і повний вигляд одного файлу ніколи не розходяться.
• Галерея показує невелике зображення початку файлу Markdown замість загального значка документа.
• Quick Look (Cmd+Y) — власний перегляд macOS, і він не зачеплений: ця панель належить системі, і жоден плагін не може в ній малювати.

Структура документа

Натисніть Символи у переглядачі, щоб отримати заголовки документа, вкладені так, як вони написані, і клацніть один, щоб перейти до нього на сторінці. Це працює і у відформатованому вигляді, і у вихідному тексті, і обидва згодні щодо того, де заголовок.

Діаграми та математика

Блок коду з мовою mermaid стає діаграмою; $…$ і $$…$$ стають набраною математикою. І те, і те малюється на вашому Mac засобами, що постачаються всередині плагіна: нічого не завантажується, і жодна частина документа нікуди не надсилається. Знак долара всередині блоку коду або вбудованого коду залишається знаком долара.

Документ без діаграм і без формул не завантажує жодного із засобів, тож звичайний README не коштує нічого додатково. Діаграма, яку не вдалося прочитати, показує помилку там, де був блок, із власним текстом блоку під нею, замість того щоб зникнути.

І те, і те можна вимкнути окремо в Конфігурація ▸ Налаштування ▸ Markdown, де також видно, яка версія використовується і звідки вона.

Ваша власна версія

Якщо потрібна новіша або інша збірка Mermaid чи KaTeX, покладіть її в теку, яку відкриває кнопка Engine Folder…, і буде використана вона замість постачуваної. Імена файлів: mermaid.min.js, katex.min.js, katex.min.css та auto-render.min.js. З інтернету для вас ніколи нічого не завантажується.

Зробити PDF

Коли курсор стоїть на файлі .md чи .html, Команди ▸ Експортувати в PDF… — або той самий пункт у контекстному меню панелі — записує документ як PDF поруч із ним, під його власною назвою. Пропонується лише у звичайних теках — усередині архіву чи на змонтованому диску немає файла на диску, щоб прочитати, і немає місця поруч, щоб записати. Позначте кілька документів, і вони експортуються один за одним.

PDF — це та сама сторінка, яку ви бачите за F3: та сама таблиця стилів, той самий розфарбований код, ті самі діаграми й та сама математика. Верстається типово на A4 (Letter — це налаштування), розриви сторінок падають між абзацами, пунктами списку та рядками таблиці, а не посеред рядка тексту, і жодна сторінка не починається без заголовка, яким починається її розділ. Документ із чимось заширшим за текстову колонку — таблицею з багатьма стовпцями, довгим нерозривним рядком — зменшується, щоб уміститися, а не обрізається з краю, так само, як це робить друк у браузері.

На сторінці налаштувань плаґіна, під PDF:

• Папір — A4 або US Letter.
• Замінювати наявний PDF із такою самою назвою — типово вимкнено, тож другий експорт записується поруч із першим як Name 2.pdf, а не перезаписує його.
• Показати новий PDF у панелі — переводить панель на щойно записаний файл. Коли це вимкнено, ви натомість отримуєте коротке повідомлення, щоб експорт ніколи не був мовчазним.

Документ, завеликий для форматованого перегляду (див. Обмеження), експортувати теж не вдасться; повідомлення його назве.

Чого відформатована сторінка не зробить

Відформатована сторінка навмисно відрізана, бо файл Markdown — це вміст, що прийшов звідкись іще:

• Вона нічого не завантажує через мережу. Зображення, адреса якого починається з http, навмисно залишається порожнім: його завантаження повідомило б тому серверу, коли ви відкрили файл і з якої адреси. Зображення, що лежить поряд із документом на диску, завантажується звичайно.
• Власні скрипти та HTML документа ніколи не виконуються. HTML, записаний у файлі Markdown, показується як текст, а файл .html відображається з вимкненими скриптами.

Вимкнення

Вимкніть плагін у Конфігурація ▸ Плагіни…, і файли .md та .html відкриватимуться як текст. Структура працює далі, підсвічування синтаксису працює далі, і більше нічого не змінюється — відформатований вигляд просто не пропонується. Те саме, якщо на сторінці налаштувань плагіна вимкнути лише відформатований вигляд.

Обмеження

• Файли понад межу розміру (типово 8 МБ, на сторінці налаштувань) відкриваються як текст. Перетворювати дуже великий згенерований документ на відформатовану сторінку повільно, а текстовий переглядач відкриває його відразу.
• Відформатовану сторінку не можна редагувати. Для цього використовуйте F4 або вигляд Текст для Форматувати, Кодування та Перейти, які застосовуються до вихідного тексту, а не до відмальованої сторінки.