Волшебный чемоданчик для работы с документами
Несколько лет назад я написал методическое пособие по работе в Microsoft Word. В нем рассказывал о стилях, автоматическом оглавлении, нумерации, перекрестных ссылках и других инструментах для подготовки больших документов.
Системная работа с документами привела меня к новой идее. Можно организовать работу над многостраничными документами таким образом, чтобы большую часть рутины по написанию текста выполняли ИИ-агенты.
Давайте разберемся что нужно для того, чтобы нейросети делали создавали документы за нас.
Что лежит в нашем чемоданчике?
Obsidian
Основа всей системы. Он хранит заметки в Markdown-файлах и позволяет связывать их внутренними ссылками.
Вместо одного большого документа появляется база знаний из небольших заметок. В каждой можно сохранить отдельную мысль, описание метода, результат, таблицу или ссылку на источник. Затем эти материалы используются повторно при подготовке отчетов, статей, презентаций и страниц сайта.
Markdown разметка позволяет хранить изображения, схемы, простые таблицы и даже формулы.
$ E = m \cdot c^2 $
Синтаксис Markdown максимально прост. Он имеет набор символов, которые однозначно описывают структуру документа. По сути разметка разделяет смысловое содержание текста и оформление. Поэтому нейросети получают доступ к смыслу не утяжеляя контекст оформлением.
Mermaid
Программа предназначена для схем, которые можно описать текстом: процессов, алгоритмов, классификаций и связей между объектами.
В файле кодом описываются блоки, подписи и стрелки, а Mermaid автоматически выстраивает из них схему. Такое представление удобно редактировать с помощью ИИ-агентов. Исходник остается текстом и хранится рядом с остальными заметками.
Mermaid поддерживает множество представлений: графики, диаграммы, графики, майндмапы, таймлайны, ганты, санкеи, канбаны 🥵 и все такое.
Excalidraw
Сервис для создания схем со свободной композицией. В нем удобно вручную размещать блоки, рисовать связи, добавлять изображения и быстро набрасывать идеи. Его лучше использовать там, где важны расположение элементов, визуальные акценты и возможность рисовать вручную.
Отображение схем Mermaid поддерживается в Obsidian изначально. Для полноценной работы с файлами Excalidraw нужно установить плагин для Obsidian.
Codex
ИИ-агент, которому можно открыть всю папку с базой знаний. Он анализирует связанные материалы, создает и редактирует файлы, проверяет результат и выполняет комплексные задачи над всей базой знаний.
Повторяющиеся правила можно закрепить в проекте. Для сложной работы Codex сначала составляет план, а независимые части большой задачи может выполнять параллельно.
- подготовка документов;
- закрепление правил;
- режим планирования задач;
- параллельная работа над несколькими задачами.
Cursor
Рабочая среда с ИИ-агентами от разных производителей. На самом деле рабочих сред с ИИ-агентами огромное количество. Они не сильно отличаются друг от друга и можно выбрать любую, которая вам больше нравится.
Wispr Flow
Инструмент голосового ввода. Он вызывается горячей клавишей, записывает речь и вставляет готовый текст туда, где находится курсор.
Программа расставляет знаки препинания, убирает часть мусорных слов и учитывает пользовательские словари. С ее помощью можно надиктовывать заметки и формулировать запросы для Codex или Cursor.
После пробного использования я, конечно, удалил это приложение. Не нашел для себя преимуществ. Просто я люблю печать текст на клавиатуре, а с ИИ-агентами можно пообщаться голосом и встроенными инструментами.
В волшебном чемоданчике приложение оказалось потому, что кому-то оно может упростить ввод текста.
Как все работает вместе?
В общем виде подход выглядит так:
- Obsidian хранит базу знаний и связи между заметками. Позволяет редактировать текст, изображения, формулы, таблицы, объекты Mermaid и Excalidraw. По сути он является средой разработки документов по аналогии с программированием.
- Mermaid создает формальные схемы, графики и диаграммы.
- Excalidraw создает концептуальные схемы и рисунки.
- Codex или Cursor позволяет выполнять комплексные задачи над документами и всей базой знаний с помощью ИИ-агентов.
- Wispr Flow преобразует речь в заметки и запросы для ИИ-агентов.
Каждая программа решает свою задачу, но вместе они образуют единую среду для работы с документами.
Почему же Microsoft Word не подходит для создания базы знаний?
Все дело в том, что синтаксис Markdown прост и понятен нейросетям.
# Обсидиан знаний **Obsidian** — https://obsidian.md Лучшие приложения создаются на основе простой, но гениальной идеи. В основе этого приложения лежит концепция атомарных заметок, связанных ссылками.
Одна решетка обозначает заголовок первого уровня, а двойные звездочки - смысловое выделение. Шрифт, размер заголовка и отступы определяет программа, которая показывает документ. Текст при такой разметке удобно читать даже не отключая спецсимволы.
Как же хранит текст Microsoft Word? На самом деле если открыть файл архиватором, то мы увидим внутри xml-документы, в одном из которых тот же самый фрагмент будет выглядеть следующим образом.
<w:p w14:paraId="24E123AB" w14:textId="77777777" w:rsidR="00194E5C"
w:rsidRPr="00194E5C" w:rsidRDefault="00194E5C" w:rsidP="00194E5C">
<w:pPr>
<w:pStyle w:val="1"/>
<w:rPr>
<w:rStyle w:val="ae"/>
<w:lang w:val="en-US"/>
</w:rPr>
</w:pPr>
<w:r w:rsidRPr="00194E5C">
<w:rPr>
<w:rStyle w:val="ae"/>
</w:rPr>
<w:t>Обсидиан знаний</w:t>
</w:r>
</w:p>
<w:p w14:paraId="4269EBBE" w14:textId="34FE8FD8" w:rsidR="00194E5C"
w:rsidRPr="00194E5C" w:rsidRDefault="00194E5C" w:rsidP="00194E5C">
<w:r w:rsidRPr="00194E5C">
<w:rPr>
<w:b/>
<w:bCs/>
</w:rPr>
<w:br/>
</w:r>
<w:proofErr w:type="spellStart"/>
<w:r w:rsidRPr="00194E5C">
<w:rPr>
<w:b/>
<w:bCs/>
</w:rPr>
<w:t>Obsidian</w:t>
</w:r>
<w:proofErr w:type="spellEnd"/>
<w:r w:rsidRPr="00194E5C">
<w:t xml:space="preserve"> — </w:t>
</w:r>
<w:hyperlink r:id="rId5" w:tgtFrame="_blank" w:history="1">
<w:r w:rsidRPr="00194E5C">
<w:rPr>
<w:rStyle w:val="ac"/>
</w:rPr>
<w:t>https://obsidian.md</w:t>
</w:r>
</w:hyperlink>
</w:p>
<w:p w14:paraId="7485A32C" w14:textId="77777777" w:rsidR="00194E5C"
w:rsidRPr="00194E5C" w:rsidRDefault="00194E5C" w:rsidP="00194E5C">
<w:r w:rsidRPr="00194E5C">
<w:t>Лучшие приложения создаются на основе простой, но гениальной
идеи. В основе этого приложения лежит концепция атомарных заметок,
связанных ссылками.</w:t>
</w:r>
</w:p>
Microsoft Word вместе с текстом хранит привязки к стилям, перекрестным ссылкам и еще кучу вспомогательных данных. Любые изменения внешнего вида текста, будут описаны в этом файле. Чем менее системно оформлен документ, тем сложнее будет найти в нем смысл текста.
Как оформить окончательный документ?
Документ собирается с помощью вложений в отдельном файле.
## Почему старый подход перестал работать ![[Почему итоговый документ не должен быть хранилищем знаний]] ## Как устроена новая система ![[Атомарные заметки позволяют повторно использовать текст]] ![[Mermaid хранит логику схемы в виде кода]] ![[Codex собирает документы из связанных материалов]]
Оформление документа для вывода на печать настраивается с помощью СSS. Это такой язык описания внешнего вида документа, написанного с использованием HTML-разметки. По умолчанию у встроенных файлов в Obsidian слева добавляется фиолетовая рамка и название заметок. Мне эта фиолетовая полоса никогда не нравилась 🙃 и ее можно отключить.
/* Отключение фиолетовой полосы при встраивании файла */
body {
--embed-border-start: none;
--embed-padding: 0;
}
/* Отключение названия при встраивании файла */
.markdown-embed-title {
display: none;
}
/* Отключение отображения названия файла */
.inline-title {
display: none;
}
Файл с кодом нужно сохранить с специальной папке .obsidian/snippets/simplify.css, а затем включить в настройках.
Аналогичным образом можно настроить стили заголовков и обычного текста: шрифты, отступы, интервалы... в общем, выдать любое оформление. Кроме того, через CSS можно настроить верстку для страниц.
Этот фрагмент задает формат листа, поля, нумерацию страниц, а также защищает заголовки, таблицы и изображения от разрыва.
/* Параметры страницы и колонтитулы */
@page {
size: A4 portrait;
margin: 20mm;
@bottom-center {
content: "Страница " counter(page) " из " counter(pages);
}
}
/* Печатная верстка */
@media print {
h1, h2, h3 {
break-after: avoid;
}
table, img {
break-inside: avoid;
}
}
Файл с кодом нужно также сохранить в папке .obsidian/snippets/print.css, затем включить его в настройках и экспортировать заметку в PDF.
Получается теперь для оформления многостраничных документов Microsoft Word больше не потребуется, а все содержимое храниться в доступном для нейросетей виде.
Такой подход позволяет многократно использовать накопленные знания для написания документов и делать запросы к ИИ-агентам для аналитики по вашей базе знаний.