Markdown и вики-ссылки

Режимы отображения

Заметки .md открываются с редактором и чтением рядом (настраивается). Разметка приглушается вне абзаца, где находится курсор, — так страница выглядит как готовый документ.

Горячие клавиши: Ctrl+B/Ctrl+I — жирный/курсив, Ctrl+E переключает режим просмотра (редактор → разделённый → форматированный → чтение).

Меню /: в форматированном редакторе наберите / в начале строки (отступ не мешает) или после пробела — список вставки откроется у курсора. Набирайте, чтобы отфильтровать (/таблица, /выноска, /h1), выбирайте клавишами ↑/↓ и вставляйте по Enter; Esc или пробел закрывают список, а набранное остаётся текстом. В правом столбце показана разметка, которую пишет каждый пункт, — в следующий раз её можно набрать сразу. Внутри блока кода, формулы или ячейки таблицы меню не открывается.

Режим чтения: последний режим Ctrl+E — тот же экран, что и форматированное редактирование, но только для чтения, и именно поэтому он может показать то, чего нет в файле: оглавление по токену [TOC]. Список папки по токену [files] и текст заметок, включённых через ![[заметка]], показываются и в форматированном редактировании. Ничего из этого не записывается в .md: в файле остаётся токен, а созданный текст не принимает правки. В этом режиме одиночный щелчок открывает ссылки, викиссылки и метки (без Ctrl), а кнопки редактирования отключены — в том числе отменить, вырезать и вставить, которые раньше действовали на текстовый редактор вне экрана. Копировать по-прежнему работает и копирует то, что вы видите. Ctrl+F ищет в том, что на экране; строка заменить отключена, с причиной в подсказке, потому что замена здесь не дошла бы до файла.

Расчёты с единицами, в режиме чтения. Строка, оканчивающаяся на =, получает результат: 3,5 km / 2 s = показывается как 3,5 km / 2 s = 1,75 km/s. Файл не меняется — та же идея, что у [TOC] и оформленной цитаты. Он делает анализ размерностей, и именно этим оправдывает себя: 1 km + 1 s = отклоняется с указанием обоих, потому что калькулятор, который вернул бы там 2, был бы не хуже — он был бы лгущим, а в лабораторном журнале такая ошибка дожила бы до статьи. Складывать одну и ту же величину в разных единицах можно, и она переводится (2 h + 30 min =), а результат выходит в той единице, которую вы написали. Он знает приставки СИ, физические постоянные (c, h, k_B, N_A, g…), явный перевод (3 km in m, также to и ->) и неопределённость: (2,00 ± 0,05) m / (1,0 ± 0,1) s = распространяет погрешность и пишет только те знаки, которые позволяет измерение. Код и формулы остаются в стороне — внутри ограды ```, между обратными кавычками или в $…$ знак = в конце строки — это синтаксис чего-то другого. А строка, которая не является расчётом (Итого =), молча остаётся как есть.

Он выключен по умолчанию: включите его в Настройки → Функции → Научное → Калькулятор с единицами.

Карточки с интервальным повторением. Заметка, получившая метку #flashcards, становится колодой: внутри неё каждая строка Вопрос::Ответ — это карточка, ::: создаёт ещё и обратную карточку, одиночный ? между двумя строками даёт многострочную карточку, а ==вот так== становится пропуском. Без метки ни в одной заметке нет карточек — именно это не даёт std::vector из заметки о программировании превратиться в карточку, которую вы не писали. Инструменты → Карточки → Повторить карточки открывает сессию: ответ остаётся скрытым, пока вы его не запросите (в этом и весь смысл — видеть оба сразу значит перечитывать, а перечитывание не запоминается), а на четырёх оценках написано, сколько времени покупает каждая. Расписание строит FSRS, тот же алгоритм, что и в Anki.

Личность карточки — это ВОПРОС: исправление ответа не трогает расписание, а переписанный вопрос отправляет карточку на покой и начинает другую — и это правильно, потому что учите вы именно вопрос. История лежит в открытом файле рядом с заметкой (заметка.md.cards.ndjson): её можно вести в Git и читать любым редактором, ценой одного лишнего файла в папке. Экспорт в Anki пишет текстовый файл, который он импортирует, — расписание с ним не уходит, потому что текстовый импорт Anki его не принимает; оно остаётся в .ndjson.

Блоки кода

Блок кода выводится с подсветкой. Ограждение с указанным языком (```python) подсвечивается по токенам теми же цветами, что и редактор кода, включая тему кода, выбранную для этого окна. Действует в форматированном редактировании, в режиме чтения, в экспортированном файле и в ответах Спросить заметки. Ограждение без указанного языка остаётся одноцветным, как и язык без доступной подсветки: текст никогда не пропадает.

Свёртывание, закрепление и экспорт

Сворачивание разделов и закрепление заголовка работают и в форматированном режиме, и в режиме чтения. Ctrl+Shift+[ сворачивает раздел под курсором, Ctrl+Shift+] разворачивает его; щелчок по стрелке слева от заголовка делает то же самое, а Вид → Свернуть все заголовки / Развернуть все заголовки действует на ту поверхность, которая сейчас на экране. При прокрутке заголовки, ушедшие вверх, закрепляются в полосе сверху — щелчок по одному из них переходит к его разделу. Сворачивание — это состояние экрана: .md не меняется, а свёрнутый текст остаётся в файле.

Экспорт: PDF и HTML создаются из того же документа, что и режим чтения — получается файл ровно с тем, что вы только что прочитали, вместе с оглавлением, списком папки и включёнными заметками. HTML самодостаточен (локальные изображения встраиваются), а PDF содержит векторный текст, поэтому по нему можно искать. HTML выходит с семантической разметкой — заголовок с якорем, врезка в <aside>, таблица с шапкой, сноска с обратной ссылкой — и с формулами в MathML: это настоящий текст, он копируется, читается вслух и не размывается при увеличении. Тема зависит от формата: HTML сохраняет цвета, которые вы видите на экране, включая тёмную тему (у файла собственный фон); PDF всегда выходит на светлой бумаге, потому что он предназначен для печати и отправки — если тема содержимого тёмная, он печатается со светлой темой по умолчанию, а уже используемая светлая тема сохраняется. Word, OpenDocument, LaTeX, Typst и EPUB LightNote создаёт сам, ничего устанавливать не нужно.

В .docx и .odt попадают заголовки, списки, таблицы, сноски, изображения, а формулы становятся редактируемыми — формулами Word в одном случае и объектами LibreOffice Math в другом; .tex получает полную преамбулу и компилируется в pdfLaTeX, XeLaTeX и LuaLaTeX. Если в папке есть библиография и раздел Академическое включён, .tex выходит с живой цитатой: [@ключ] становится \autocite, токен [bibliography] — \printbibliography, а рядом сохраняется refs.bib только с процитированными работами — приложение об этом сообщает. Компилируйте через biber.

.typ — то же самое на Typst, который компилируется за секунды и не требует установленного дистрибутива LaTeX: формула едет в LaTeX через пакет mitex (скачивается при первой компиляции), а цитата выходит как @ключ с #bibliography.

.epub — это электронная книга: одна глава на заголовок 1-го уровня, оглавление для навигации, изображения как файлы пакета и та же семантическая разметка, что и в HTML. .ipynb — это блокнот Jupyter: проза становится текстовой ячейкой, а блок на языке ядра — ячейкой кода, и только он: ячейка кода уходит в ядро, и диаграмма Mermaid, превращённая в ячейку, при первом же запуске выполнилась бы как Python. Ядро берётся из ключа kernel в свойствах заметки или из самого частого блока.

Вывод не выдумывается: ячейки выходят без результата, потому что результат бывает от запуска — то же правило, которому уже следует импорт блокнота, отбрасывая сохранённые выводы. И есть Markdown для…: та же заметка на диалекте назначения — блок > [!NOTE] на GitHub, !!! note в MkDocs, :::note в Docusaurus, ::: {.note} в Pandoc, запись Obsidian или строгий CommonMark.

Викиссылка становится относительной (кроме Obsidian), а комментарий %%…%% не публикуется, потому что он личный. Если Typst установлен (winget install --id Typst.Typst), сам экспорт предлагает Скомпилировать PDF прямо там; без него кнопка становится Установить Typst... и открывает руководство. Если курс или заказчик выдаёт шаблон Word, укажите его .docx в разделе Настройка рабочего пространства → Цитаты и список литературы → Шаблон Word: экспортированный файл выходит со стилями, форматом бумаги, полями и колонтитулом шаблона. Отдельная заметка может выбрать другой, объявив reference-docx: shablon.docx в своих свойствах. Все три формата строятся из Markdown режима чтения — со сформатированными цитатами и пронумерованными рисунками, — а то, что не удалось перенести, называется в конце экспорта. Компиляция идёт в фоне, как задача в центре активности: окно продолжает отвечать, а Остановить прерывает её.

Диаграмма Mermaid и химическая структура входят изображением — в .docx, .odt и EPUB на светлой бумаге, в HTML в цветах экрана; только через lnote, у которого нет окна, чтобы их нарисовать, они выходят блоком кода. Есть и Размеченный текст для…: reStructuredText, AsciiDoc, Org mode, MediaWiki и простой текст — их тоже пишет сам LightNote. Каждый получает свою родную конструкцию, а не подражание: блок становится .. note:: в Sphinx, [NOTE] в AsciiDoc и #+begin_note в Org; формула — .. math::, latexmath:[], чистым LaTeX и <math>; сноска — footnote:[] и <ref>. В простом тексте разметки нет вовсе — таблица выходит выровненной по столбцам, чтобы поместиться в письмо или в сообщение коммита. Чего в формате нет, говорится в конце: в ядре MediaWiki нет такого блока (он становится цитатой с подписью полужирным), а в reStructuredText нет зачёркивания. Чтобы унести фрагмент, не записывая файл, в контекстном меню редактора есть Копировать выделенный фрагмент как (или Копировать заметку как, если ничего не выделено): форматированный текст для вставки в Word, Google Документы или письмо, Markdown для GitHub, LaTeX и Typst. LaTeX и Typst содержат только основной текст — без преамбулы и заголовка, — потому что в документе назначения они уже есть; пакет, который нужен фрагменту, и цитата, зависящая от библиографии документа назначения, указываются в строке состояния, а комментарий %%…%% тоже не переносится.

RTF находится в Другие форматы (pandoc) и идёт через pandoc — отдельную программу (winget install --id JohnMacFarlane.Pandoc). Без неё этот пункт выключен, и рядом сказано почему, а Установить pandoc... в том же подменю открывает руководство и выполняет установку. Если pandoc уже установлен в другом месте, укажите файл через Уже установлено: указать на диске... в руководстве или в разделе Настройки → Инструменты кода → Внешние программы.

Экспорт с параметрами... — первый пункт меню экспорта; меню вкладки и Файл → Экспортировать заметку — одно и то же меню. Он показывает все форматы с поиском по названию, назначению и расширению (wiki находит MediaWiki, sphinx — reStructuredText) и только те параметры, что относятся к выбранному формату: Оглавление в начале, если в заметке ещё нет [TOC]; Язык документа, от которого зависят переносы и подписи, создаваемые самим документом; Цитаты живые или разрешённые в тексте — для LaTeX и Typst; Шаблон Word с флажком, делающим его шаблоном папки по умолчанию; Формулы HTML и EPUB в MathML или изображением — для старых читалок или HTML, вставляемого в письмо; Бумага PDF, A4 или Letter; и Сразу скомпилировать PDF в Typst. Параметр, который относится к формату, но недоступен, отключён с объяснением причины — живые цитаты без библиографии в папке, — а формат, зависящий от отсутствующей программы, тут же предлагает её установить. Последний выбор запоминается для каждой папки, и диалог открывается таким, каким вы его оставили; прямые пункты меню по-прежнему экспортируют с заводскими значениями, чтобы выбор, сделанный недели назад, не менял файл, создаваемый сочетанием клавиш. Написанный в заметке [TOC] работает во всех форматах: он становится оглавлением в Word и LibreOffice (Word обновляет его при открытии), \tableofcontents в LaTeX, #outline() в Typst и списком ссылок в HTML и Markdown. В форматированном тексте команды Копировать выделенный фрагмент как формула и диаграмма уходят изображением, с исходным LaTeX в альтернативном тексте: неизвестно, куда текст будет вставлен, и одинаково в Word, Google Документах и письме выглядит только изображение — если нужна редактируемая формула, экспортируйте .docx или .odt.

Папка целиком тоже выходит: Файл → Экспорт папки... (или правый щелчок на папке в дереве) превращает её заметки в сайт HTML — по странице на заметку, с указателем, если ни одна заметка ещё не стала index.html, — в набор .docx или .odt либо в дерево Markdown на диалекте назначения. Структура подпапок сохраняется, ссылки и викиссылки между заметками начинают указывать на вышедшие файлы (в Word и LibreOffice тоже, из документа в документ), а изображения и вложения, которые живут внутри папки, идут вместе с ними, на то же место. То, что вне её, не копируется: остаётся так, как вы написали, и отчёт в конце перечисляет каждый случай вместе со ссылками без цели. Папка назначения должна быть пустой — или вы отмечаете Заменять файлы с тем же именем — и не может содержать экспортируемую папку. Без окна: lnote folder-export --path . --format html --out site и инструмент folder_export по MCP; там трансклюзия, [files] и нумерация рисунков не разрешаются, потому что разрешает их окно.

Форматированное редактирование

Форматированное редактирование (WYSIWYG): четвёртый режим показывает заметку такой, какой она получается — заголовок кеглем заголовка, список с маркером, таблицу сеткой и изображение прямо в тексте — а не разметку. Файл остаётся тем же .md: его пишет LightNote, а не Qt, и поэтому жирный, курсив, вики-ссылки, трансклюзия и врезки переживают путь туда и обратно. Войти в режим и выйти без правок не меняет в файле ни байта. Панель предлагает только то, что представимо в Markdown — заголовок, жирный, курсив, зачёркнутый, код, списки (с флажком задачи), цитату, ссылку, таблицу и горизонтальную линию; выравнивание, отступ и размер шрифта остались за бортом, потому что потерялись бы при сохранении.

Внутри таблицы Tab переходит по ячейкам и на последней создаёт следующую строку. Enter в пустом месте справа от таблицы — туда попадает курсор при щелчке справа от строки — добавляет строку в конец, а курсор ставится в первую ячейку. Внутри ячейки Enter переносит строку на месте (в файл это уходит как <br> — единственная форма, которую принимает таблица Markdown), а Ctrl+Enter создаёт строку ниже, курсор остаётся в том же столбце. При наведении на таблицу появляются неброские рукоятки: слева от строки — пара стрелок, которая двигает её вверх или вниз (её же можно перетащить, чтобы отнести строку в другое место); над столбцом — пара, которая двигает его вбок; и + на нижней и на правой границе, добавляющие строку и столбец. Первая строка — заголовок, и она не двигается. Всё это есть и в контекстном меню, в разделе Таблица. Там же есть Удалить таблицу — безопасный способ убрать её целиком.

В рамке (<details> или :::) последняя строка закрывает рамку и не удаляется: именно она не даёт содержимому снизу попасть внутрь. Чтобы убрать рамку, сохранив текст, воспользуйтесь пунктом Убрать рамку в контекстном меню. Enter всегда создаёт строку. В пустом пункте списка он выходит из списка, не добавляя строки — как в Word, — а в пустом абзаце создаёт пустую строку. Одна пустая строка в файле — это обычное разделение абзацев, и она не показывается как пустая строка; со второй показывается и возвращается в файл ровно такой, какой вы её написали.

Перетаскивание правого края изображения меняет его размер, и ширина уходит в файл как ![alt|300](foto.png). На панели двенадцать элементов: полужирный, курсив и заголовок напрямую, плюс два меню, которые делят остальное по назначению — Формат действует на уже написанное (разметка, списки, цитата, выравнивание таблицы и операции Текст), а Вставить создаёт новое (ссылка, изображение, таблица, блок, диаграмма, формула, выноска). Форматирование таблицы и меню Текст по-прежнему принадлежат текстовому редактору: здесь они выглядят отключёнными, с указанием причины. Приглушение разметки перешло на кнопку Отображение, рядом с колонкой чтения и прокруткой как у пишущей машинки, которые работают во всех четырёх режимах. А меню Вставить предлагает здесь то же, что и в текстовом редакторе — выделение, верхний индекс, нижний индекс, викиссылка, сноска, выноска (callout), сворачиваемый блок, оглавление и список определений —, всё, что этот режим уже умел показывать и не умел создавать.

То, что показывает режим чтения, теперь показывает и форматированное редактирование. Эмодзи :fire: отображается как 🔥, ==выделенный== текст — как жёлтая пометка, ^2^ и ~2~ — как верхний и нижний индекс, #метка — как пилюля, а голый веб-адрес — как ссылка. Файл сохраняет записанную форму: открытие заметки ничего не переписывает. Правка внутри отображённого фрагмента сохраняет разметку — если печатать посреди выделения, оно остаётся выделением, — а то, что набрано сразу после него, остаётся снаружи. Комментарий %%…%% остаётся видимым, приглушённым: спрятать его значило бы сделать его невидимым и нередактируемым.

Выноски становятся рамкой и в форматированном редактировании. Цитата, начинающаяся с > [!NOTE] — или [!TIP], [!IMPORTANT], [!WARNING], [!CAUTION] — показывается с цветной полосой и заголовком, как в режиме чтения: маркер уступает место названию типа или вашему собственному заголовку, если написать > [!TIP] Мой заголовок. В файле остаётся записанный маркер, а правка заголовка сохраняет тип выноски. Названия блоков из Obsidian и MkDocs тоже распознаются: [!SUCCESS], [!ABSTRACT], [!FAILURE], [!QUESTION] и их синонимы (tldr, missing, faq) попадают в ближайший блок, поэтому заметка оттуда сразу выглядит цветной — а при экспорте каждый формат получает то название, которое он знает.

Это режим по умолчанию при новой установке. У тех, кто уже пользовался LightNote, сохраняется прежний режим; чтобы изменить его, откройте Настройки → Общие → Начальный вид Markdown. Щелчок по заголовку в Структуре выполняет переход внутри текущего режима, не выводя вас из форматированного редактирования или чтения.

Выравнивание столбца таблицы. Когда курсор внутри таблицы, контекстное меню предлагает Таблица → Выровнять столбец: По левому краю, По центру, По правому краю или По умолчанию. Выравнивание относится к всему столбцу — именно так его представляет Markdown — и попадает в файл в строку-разделитель (:--, :-:, --:); По умолчанию возвращает к ---. Галочка в меню показывает, что действует сейчас: на экране столбец --- и столбец :-- выглядят одинаково.

Структура показывает то, что на экране. Список заголовков берётся с той поверхности, которую вы сейчас видите: в форматированном редакторе только что набранный заголовок появляется сразу, не дожидаясь, пока текст дойдёт до текстового редактора; в режиме чтения в него входят и заголовки заметок, вставленных через ![[заметка]], — они тоже часть того, что вы читаете. Щелчок по пункту в обоих случаях ведёт к нужному заголовку. А в режиме разделённого экрана прокрутка теперь двусторонняя: прокрутка области чтения тянет за собой текстовый редактор — как это уже работало в обратную сторону.

Разметка становится форматом прямо при вводе. Если написать **тест**, применится жирный, а звёздочки исчезнут; то же с *курсивом*, ~~зачёркнутым~~, `кодом` и формами с подчёркиванием. В начале строки #  … ######  становятся заголовками, -  и 1.  — списками (введённое число задаёт начало), - [ ]  — задачей с флажком, >  — цитатой, а одиночное --- по Enter — горизонтальной линией. Маркеры, которые что-то рисуют, срабатывают уже на пробеле; только заголовок ждёт первой буквы, потому что пустой заголовок ничего не показал бы.

Ctrl+Z отменяет только преобразование и возвращает разметку как есть — выход для того, кто действительно хотел звёздочки. Вставка тоже преобразует: вставленный текст с разметкой приходит уже оформленным, без символов. Здесь правило осторожнее, чем при вводе — срабатывает только однозначная разметка, — потому что при вставке вы не видите, как складывается результат: так фрагмент кода, полный * и _, остаётся кодом. Внутри блока кода не преобразуется ничего: там разметка и есть предмет. Чтобы выключить всё: Настройки → Общие → Преобразовывать разметку при вводе.

Из Word, Google Документов или со страницы приходит текст со структурой: заголовок, список (включая список Word, который внутри вообще не список), таблица, ссылка, код в строке и блок кода с языком. Шрифт, размер и цвет источника остаются за бортом: Markdown их не представляет, а сохранённые они оставили бы синий фрагмент Arial, исчезающий при сохранении. Картинка, пришедшая вместе с текстом, становится вложением заметки, если Word или браузер оставили её во временной папке, которая очищается сама; картинка со ссылкой на интернет остаётся ссылкой, а её контекстное меню предлагает Скачать изображение в рабочее пространство.

Изображения, ссылки и викиссылки

Изображение и ссылка. Вставить изображение можно тремя путями: Вставить → Изображение... на панели, ввести ![](foto.png) или перетащить файл в заметку — изображение вставляет изображение, заметка .md вставляет [[вики-ссылку]], а любой другой файл превращается в кликабельную ссылку, подписанную именем файла, — а если перетащить несколько сразу, каждый окажется на своей строке. Сохранённый путь по возможности относителен папке заметки, чтобы заметка продолжала работать после переноса хранилища. Адрес ссылки в тексте не виден (видна подпись), поэтому он показывается в строке состояния при наведении, а Ctrl+клик открывает его: веб-адрес — в браузере, локальный путь — в LightNote.

Изменить готовую ссылку: поставьте в неё курсор и нажмите кнопку Ссылка (или Изменить ссылку… в контекстном меню) — окно откроется с заполненными текстом и адресом. В контекстном меню на ссылке есть и Копировать адрес ссылки, и Удалить ссылку — она снимает ссылку, оставляя текст. На [[вики-ссылке]] есть Открыть заметку и Скопировать цель, на #теге — Найти тег и Скопировать тег. На изображении есть Альтернативный текст… (в форматированном режиме он не виден, но уходит в файл и в поиск) и, после перетаскивания рукоятки, Исходный размер, который возвращает изображению его собственный размер. На изображении с веб-адресом появляется Скачать изображение в рабочее пространство: файл попадает в Вложения/ рядом с заметкой, и заметка указывает на него — иначе она зависела бы от того, что этот URL всё ещё существует. И есть самый короткий путь: выделите текст и вставьте адрес — он станет [текст](адрес), а не заменит выделение. Работает в обеих поверхностях редактирования. Пока изображение не загружено, картинка из веба показывается как карточка с адресом и путём в меню — LightNote не выходит в сеть, чтобы нарисовать заметку, а раньше там оставалась пустая рамка «битой» картинки, ничего не поясняя.

И разметку можно снять. В меню Формат пункты Выделение, Верхний индекс и Нижний индекс показаны отмеченными, когда курсор внутри одного из них, и щелчок там снимает разметку, а не применяет её ещё раз. С клавиатуры есть быстрый путь: поставьте курсор в конец форматированного фрагмента и нажмите Ctrl+Shift+Backspace — разметка вернётся буквально, без одного символа: жирный станет **жирный* обычным текстом, а если дописать недостающий разделитель, форматирование соберётся снова. Работает для жирного, курсива, зачёркнутого, кода, выделения, верхнего и нижнего индексов. Один Backspace удаляет букву — там, как и везде.

Диаграмму можно править, не выходя из заметки. В форматированном редакторе диаграмма Mermaid и формула $$…$$ показываются нарисованными; чтобы добраться до исходника, поставьте на них курсор и нажмите Ctrl+Enter — или выберите Редактировать этот блок… в контекстном меню. Нижняя панель показывает текст, пока она открыта, заметка заблокирована, а закрытие (✕, Esc, Ctrl+Enter, щелчок по заметке) применяет изменения: путь назад — Ctrl+Z. В том же меню пункт Извлечь в новую заметку… записывает выделенный фрагмент в соседнюю заметку и оставляет на его месте [[wikilink]] — разметка уходит вместе с ним, поэтому заголовок, список и таблица попадают в новую заметку целиком. В поле показано только содержимое: строки ```mermaid и ``` (или $$) стали переключателем типа в заголовке панели, который к тому же меняет диаграмму на формулу или блок кода. Enter сохраняет отступ строки — в языке с отступами вроде Mermaid это действие каждой строки. А контекстное меню блока предлагает Копировать код Markdown и Копировать изображение — код вставляется в любой редактор Markdown и снова рисуется, изображение вставляется в письмо или чат. Оба пункта работают и в режиме только для чтения.

Попросить изменение у ИИ. Когда панель блока открыта, кнопка ИИ в заголовке открывает строку, где вы пишете, что изменить — «добавь путь ошибки, который возвращается к началу», «замени сумму на интеграл» — и Enter отправляет. Рядом с полем кнопка показывает, какой ИИ ответит: её меню меняет помощника только для этого блока, не трогая ваш ИИ по умолчанию, и содержит Посмотреть, что будет отправлено. Заглянуть стоит, потому что ИИ получает блок, заголовок и раздел заметки и текст вокруг — именно это позволяет попросить, чтобы диаграмма отражала написанное там. Ответ попадает в поле, и рисунок перерисовывается сразу: Ctrl+Z возвращает то, что вы написали сами. LightNote проверяет ответ собственным отрисовщиком и, когда он не рисуется, просит одно исправление, называя модели отвергнутую строку и команду — если и это не помогло, ответ всё равно записывается, а причина остаётся на панели, чтобы вы поправили две строки вручную. Кнопка появляется только у диаграммы, формулы и химической структуры.

Ссылка на раздел и метки из свойств. [[Заметка#Раздел]] открывает заметку на этом разделе — якорь называет текст заголовка, — а ![[Заметка#Раздел]] вставляет только его (до следующего заголовка того же или более высокого уровня, вместе с подзаголовками). Якорь, который не совпал ни с одним заголовком, говорит об этом в строке состояния, а вставка остаётся как написана: подставить туда всю заметку значило бы молча выдать другое. И tags: из фронтматтера теперь считаются метками заметки, в обоих написаниях (tags: [a, b] и список отдельными строками) — они попадают в Базы, в поиск по метке и в то, что видит ассистент, вместе с #метками из текста. Без имени заметки якорь указывает на неё саму: [[#Вывод]] переходит к этому разделу, не открывая вкладку, а ![[#Вывод]] переносит раздел туда, где вы находитесь. И якоря вкладываются: [[Диссертация#Метод#Выборка]] — это Выборка внутри Метода, а не первая с таким названием в заметке. Третья форма указывает на блок: строка, заканчивающаяся на ^id (или ^id отдельной строкой сразу под блоком), — это цель [[Заметка#^id]]. LightNote не создаёт такие идентификаторы — он лишь приводит вас к тому, что вы написали. А якорь цели, которая не является заметкой, — это адрес внутри неё: [[статья.pdf#page=3]] открывает PDF на этой странице.

Вики-ссылки: введите [[, чтобы получить автодополнение по заметкам рабочего пространства; ссылка сама закрывается символами ]]. Удерживая Ctrl и щёлкнув по [[заметке]], можно открыть соответствующую заметку. Панель Связи показывает связи между заметками. Встроенный рисунок из Obsidian тоже виден: ![[фото.png]] рисуется как изображение, а ![[фото.png|300]] учитывает ширину. В файле остаётся то, что вы написали, — путь к изображению никогда не записывается вместо токена.

А вложение, которое не является изображением, становится карточкой: ![[статья.pdf#page=3]], ![[лекция.ogg]] и ![[карта.canvas]] показываются как рамка с именем файла, по которой можно щёлкнуть, — и PDF открывается на той странице, которую вы указали. У .canvas и .base из Obsidian есть ещё одна строка: файл остаётся в папке, а LightNote его не рисует. Цель, которой не существует, остаётся такой, как вы её написали: карточка там обещала бы потерянный файл. Посреди предложения рисунок показывается так же, а вложение становится просто именем файла, которое открывается Ctrl+щелчком: карточка там разорвала бы абзац. Та же заметка под другим именем: напишите aliases: [Выборка, Метод выборки] в свойствах заметки, и [[Выборка]] будет её открывать — псевдоним попадает и в автодополнение [[. Файл с таким именем всегда побеждает псевдоним. Псевдонимы берутся из индекса папки, который приложение перестраивает в фоне при открытии рабочего пространства: только что написанный aliases: сработает на следующем проходе, а не в ту же секунду.

Панель меток

Панель меток. В полосе боковой панели есть раздел Метки: дерево всех #меток ваших заметок, вложенное по / (#project/alpha и #project/beta становятся ветвями project), а рядом — число заметок, считанное по заметкам, а не по вхождениям. При выборе метки внизу перечисляются заметки с ней (родитель показывает и заметки своих ветвей); двойной щелчок открывает заметку. Панель читает индекс, поэтому видит оба источника: #метки в тексте и tags: во фронтматтере. Ctrl+щелчок по метке внутри заметки открывает эту панель с уже выбранной меткой — раньше открывался текстовый поиск по #метка, который не находит заметку, объявившую метку во фронтматтере. Для буквального вхождения в тексте по-прежнему служит глобальный поиск.

Блоки, сноски и расширенная разметка

Расширенное чтение: блоки кода в оградках отображаются в рамке с меткой языка и ссылкой копировать; ~~зачёркнутый~~ и ==выделенный== текст отображаются корректно; а колл-ауты в стиле GitHub (> [!NOTE], [!TIP], [!WARNING], [!IMPORTANT], [!CAUTION]) превращаются в цветные рамки. Теги #хэштег подсвечиваются и по Ctrl+клику открывают поиск по этому тегу; блок YAML-метаданных (frontmatter) в начале файла (---) подсвечивается. На панели инструментов вкладки есть кнопка экспорта заметки в PDF/HTML, переключаемая по центру колонка чтения и режимы отображения заметки. Режим Zen (F11) и прокрутка в стиле печатной машинки помогают писать без отвлечений.

Сноски переходят в обе стороны. Ссылка [^1] показывается как надстрочный номер, и Ctrl+щелчок по ней ведёт к определению; в определении маркер [^1]: остаётся видимым — это цель перехода, и его нужно видеть, чтобы понимать, какую сноску вы правите, — а Ctrl+щелчок по нему возвращает к ссылке. В отличие от многих просмотрщиков Markdown, редактор не перенумеровывает сноски и не переносит определения в конец: порядок в файле ваш. Встроенная (inline) запись Obsidian и Pandoc — ^[текст сноски] — тоже отрисовывается: текст пишется там, где сноска вызывается, а в режиме чтения появляется пронумерованным в конце. В файле остаётся именно то, что вы написали, а при экспорте это становится настоящей сноской в Word, LaTeX, Typst и EPUB.

Выноска MkDocs (!!! note с телом, сдвинутым на 4 пробела) сохраняется ровно так, как написана, в форматированном редактировании: именно отступ делает тело частью выноски, поэтому её текст не получает форматирования — зато открытие заметки и сохранение не разрушают конструкцию.

Рамки с закрывающим маркером тоже показываются как рамка. :::tip … ::: (Docusaurus) и <details> … </details> получают цветную полосу и заголовок — и в компактной записи, и в записи с пустыми строками. Открывающий маркер уступает место названию типа, написанному вами заголовку или тексту из <summary>; закрывающий уходит с экрана и остаётся в файле: разметка, которую пишет само приложение, не должна оставаться на странице буквально. На экране остаётся последняя строка рамки — именно она задаёт границу, именно туда ставят курсор, чтобы писать внутри, и удалить её нельзя: иначе содержимое снизу попало бы внутрь рамки. Чтобы убрать рамку, сохранив текст, воспользуйтесь пунктом Убрать рамку в контекстном меню. : списка определений по-прежнему приглушается. Чтобы <summary> стал заголовком, он должен быть в той же строке, что и <details>: на отдельной строке он показывается как написан, а рамка сохраняет подпись по умолчанию.

Строчный HTML и блок кода. <kbd>, <mark>, <sub> и <sup> отображаются и в форматированном редактировании — теги исчезают, остаётся только содержимое, как в режиме чтения. Блок кода в ограде получает рамку, а в углу — название языка и ссылку копировать: та же ссылка в форматированном редактировании и в режиме чтения, где код копируют чаще всего. Она берёт только содержимое блока (без маркеров) и на мгновение показывает скопировано; обе надписи появляются, только когда помещаются, не наезжая на код.

Ещё о чтении: блок YAML-фронтматтера в начале файла не показывается в отрисованной заметке — он редактируется на панели Свойства. Теги #hashtag становятся кликабельными метками и открывают поиск по этому тегу (то же самое, что Ctrl+щелчок в редакторе). Комментарии в стиле Obsidian (%%это не отображается%% или блок между строками с %%) остаются только в файле. Кроме выносок GitHub, так же отрисовываются блоки диалектов Docusaurus (:::tip Заголовок … :::) и MkDocs (!!! note "Заголовок" с отступом в теле и ??? note) — удобно при чтении репозиториев с документацией.

Новое в чтении: помимо ~~зачёркнутого~~ и ==выделения==, доступны верхний индекс ^x^, нижний индекс ~x~, эмодзи по сокращению (:rocket:), автоссылки для URL, сноски [^1], сворачиваемые блоки <details>, списки определений, задачи - [ ]/- [x] (⬜/✅) и маркер [TOC] (кликабельное оглавление в режиме чтения); также локальные изображения и встроенный HTML (<kbd>, <mark>…). Панель Структура (панель вкладки) проходит по заголовкам, следуя за курсором, а кнопка Вставить (или контекстное меню → Формат/Вставить) применяет любую разметку.

Заголовки, папка и текст

Закреплённые заголовки (sticky scroll): при прокрутке заголовки, охватывающие верхнюю строку, закрепляются в полосе вверху редактора; щелчок по одному переходит к разделу (включается в Настройки → Markdown). Контекстное меню папки в дереве создаёт/открывает Заметку папки (index.md с фронтматтером) — удобно как оглавление.

Заметка папки и список файлов: двойной щелчок по папке открывает её index.md, если он существует. В любой заметке токен [files] (или [arquivos]) отдельной строкой заменяется в форматированном редактировании и в режиме чтения списком файлов папки заметки в виде кликабельных ссылок — создаётся на лету, ничего не записывая в файл (как [TOC]).

Операции с текстом и строками. Операции редактора кода работают и в заметке — через подменю Текст кнопки Формат на панели вкладки, контекстное меню и подменю Строки и Очистка меню Правка: переместить строку (или выделенные строки) вверх/вниз (Ctrl+Shift+↑/↓), продублировать (Ctrl+Shift+D), удалить (Ctrl+Shift+L), сортировка (А→Я / Я→А), обращение порядка, объединение строк, удаление повторяющихся и пустых строк, удаление пробелов и регистр (ВЕРХНИЙ/нижний/инверсия). Нумеровать строки… открывает диалог с началом, шагом, ведущими нулями и разделителем — со значением по умолчанию (". ") получается корректный нумерованный список Markdown. При наличии выделения операция применяется только к нему (расширенному до целых строк), без выделения — ко всему документу, и всегда это один шаг отмены. На панели вкладки также есть кнопка ИИ: Спросить / Изменить с ИИ — те же Ctrl+K / Ctrl+I, что и в коде, — и Спросить заметки, чат, который отвечает по заметкам рабочего пространства.

Предложить заголовок и теги. В той же кнопке ИИ заметки пункт Предложить заголовок и теги… просит ассистента по умолчанию придумать заголовок и теги для открытой заметки. Он читает заметку (у длинной — начало и конец) и список тегов, которые вы уже используете в рабочем пространстве, и предпочитает их, а не новые синонимы. Предложение появляется в небольшом редактируемом окне: измените заголовок, снимите отметку или исправьте теги. Применить записывает title: и tags: в свойства заметки — теги добавляются к уже имеющимся и никогда их не заменяют, — а если у заметки нет ни заголовка, ни строки # …, предлагает поставить заголовок и в начало. Это одна правка: Ctrl+Z отменяет её. Если ИИ не настроен, пункт предлагает подключить его. Текст заметки покидает компьютер, если ассистент — облачный сервис; с локальной моделью — нет.

Сворачиваемые заголовки: нажмите на маленькую стрелку слева от заголовка (или используйте Ctrl+Shift+[ / Ctrl+Shift+]), чтобы свернуть или развернуть раздел; в меню Вид есть Свернуть/Развернуть все заголовки. Сворачивание — чисто визуальное, оно никогда не записывается в файл, и LightNote запоминает его между сеансами. Переход из оглавления или из поиска внутрь свёрнутого раздела разворачивает его.

Папка-регистратор: папка как одно произведение

Что это: папка, заметки которой становятся главами в порядке, который объявляете вы. Годится для книги, дипломной работы, курса, руководства, рунбука или рабочего журнала — механизм один и тот же. В контекстном меню папки пункт Сделать папкой-регистратором открывает окно с заметками в текущем порядке: перетащите, чтобы изменить порядок, и подтвердите. Порядок сохраняется в ключе chapters: файла index.md этой папки — это ваш текстовый файл, он путешествует вместе с заметками и работает на любой машине. В порядке можно назвать и вложенную папку: её главы входят на то место, где она указана, а свой порядок она объявляет в своём index.md — так у книги появляются части. Обложка вложенной папки не становится страницей документа; она нужна, чтобы объявить порядок этого уровня и чтобы перемещаться.

Перемещение: при объявленном порядке на панели заметки видно Глава 3 из 12, со стрелкой с каждой стороны (Alt+PgUp и Alt+PgDn); средняя кнопка перечисляет все главы. Панель Оглавление становится двухуровневой: главы произведения и, под открытой, её заголовки. На концах произведения соответствующая стрелка гаснет. В папке без объявленного порядка ничего этого не появляется, и всё остаётся как было.

Шаблон заметок: папка-регистратор может объявить, из какого шаблона начинаются заметки, созданные внутри неё (ключ template:). Готовых шаблонов пять — глава книги, глава дипломной работы, урок, шаг процедуры и запись в журнале, — и выбор одного из них сохраняет его файлом в папке Templates, где он остаётся редактируемым. Заметка, созданная внутри папки-регистратора, сама входит в порядок; файл, положенный туда извне, остаётся Вне порядка, пока вы его не примете. Переименование главы исправляет ключ и сохраняет её место. Чтобы начать с готового произведения, Создать структуру по шаблону… (в контекстном меню папки) записывает сразу оба ключа — порядок и шаблон глав — и сохраняет уже написанную обложку; а пока объявленная глава ещё не существует, в Оглавлении появляется кнопка, которая создаёт их все разом, каждую уже по шаблону папки. Ничего не перезаписывается: глава, которая уже есть, остаётся как есть.

Объединение в один документ: при экспорте папки флажок Объединить главы в один документ выдаёт один файл с главами в объявленном порядке. Поскольку текст объединяется до отрисовки, сноски, рисунки, таблицы и ссылки затем нумеруются по всему документу — и перекрёстная ссылка из одной главы на рисунок в другой начинает работать. Всё, чего нет в объявленном порядке, не войдёт, и отчёт скажет что именно.

Свойства, тема и масштаб

Свойства заметки: боковая панель Свойства показывает YAML-frontmatter как типизированные поля (текст, число, дата, флажок), с полем Тип сверху. Именно задание типа и свойств позволяет собрать заметки в Базу.

Тема заметки: поле Тема на панели Свойства задаёт вид этой заметки — цвета и шрифт текста — не трогая тему остального приложения. Выбор попадает во фронтматтер (ключ theme), поэтому он путешествует вместе с файлом: заметка выглядит одинаково на любой машине. Соседняя кнопка записывает цвета в саму заметку, чтобы она выглядела так же даже у того, у кого этой темы нет. Без ключа заметка следует теме рабочего пространства. Если вы предпочитаете, чтобы заметки, пришедшие извне, не меняли ваш вид, отключите Учитывать тему, объявленную в заметке в Настройках → Markdown.

Тема, которой LightNote ещё не знает: список тем — это один файл, загружаемый с сайта, поэтому заметка, ссылающаяся на тему, опубликованную после вашего последнего обновления, просто её не найдёт. Тогда заметка открывается с темой рабочего пространства, а панель Свойства сообщает об этом и даёт быстрый переход к доступным темам. LightNote сам ищет обновлённый список — один раз за сеанс, в фоне и не задерживая заметку. Если вы предпочитаете, чтобы он ничего не загружал, отключите Загружать каталог инструментов онлайн в разделе Настройки → Функции.

Ctrl++ и Ctrl+− (или Ctrl+колесо мыши) меняют размер заметки, а Ctrl+0 возвращает 100% — удобно читать длинную заметку, не трогая шрифт всех остальных. Редактор и чтение масштабируются вместе: в разделённом режиме обе стороны остаются одного размера. <svg>, написанный прямо в заметке, тоже отрисовывается в режиме чтения: можно вставить график, созданный ИИ, не делая из него отдельный файл.

Сколько слов и где именно. Строка состояния считает слова заметки и оценивает время чтения; рядом раздел N — это счёт раздела, в котором стоит курсор: того самого, что подсвечивает Оглавление, от его заголовка до следующего равного или более высокого уровня. Если задать дневную цель в разделе Настройки → Заметки и письмо, появится и сегодня N/M: то, что приросло в заметках, открытых сегодня. Удаление ничего не вычитает — править собственный текст не должно быть наказанием, — заметка, которую вы не открывали, не учитывается, а в полночь счёт обнуляется.