К основному содержанию
скилл CX Codex

obsidian2epub — скилл для Claude Code: что делает и как установить

Скилл obsidian2epub конвертирует хранилища Obsidian в электронные книги EPUB с сохранением вики-ссылок, диаграмм Mermaid и вложений.

MIT 1 установок обновлён 2026-04-09

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add Unintendedsideeffects/Skills-And-Agents --skill obsidian2epub -a claude-code
Открыть на GitHub

Что делает obsidian2epub

Ассистент запускает скрипт scripts/convert.sh, собирая заметки Markdown из хранилища Obsidian в готовый файл .epub. Скилл сохраняет внутренние вики-ссылки [[note]], переносит вложенные файлы и выстраивает порядок глав. Упорядочить заметки можно вручную через файл карты содержания (--moc) или автоматически с помощью алгоритма HITS.

Для отрисовки схем Mermaid в формат SVG потребуется глобально установить пакет @mermaid-js/mermaid-cli — без него диаграммы не попадут в книгу. Оформление строится на светлой или тёмной теме Flexoki, а выборку заметок легко отфильтровать регулярными выражениями через --include и --exclude.

Какие задачи решает

  • собрать электронную книгу EPUB из заметок Obsidian
  • сконвертировать диаграммы Mermaid в SVG внутри книги
  • упорядочить главы базы знаний алгоритмом HITS или через MOC-файл
  • отфильтровать черновики из итоговой сборки по регулярному выражению

Примеры запросов агенту

  • Собери книгу handbook.epub из хранилища ~/Obsidian/Work с тёмной темой Flexoki
  • Экспортируй заметки из ~/Notes в book.epub, исключив папку ^Drafts/
  • Сконвертируй хранилище ~/Vault в EPUB и задай порядок глав по файлу Index.md

Как установить obsidian2epub

1Через Skills CLI (Vercel)

npx skills add Unintendedsideeffects/Skills-And-Agents --skill obsidian2epub -a claude-code

2Вручную: положить файлы

~/.claude/skills/obsidian2epub/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/obsidian2epub/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об obsidian2epub

Как установить obsidian2epub в Claude Code?

Выполните команду npx skills add Unintendedsideeffects/Skills-And-Agents --skill obsidian2epub -a claude-code. Конфигурация сохранится в ~/.claude/skills/obsidian2epub/SKILL.md.

Что делает скилл obsidian2epub?

Он автоматизирует запуск CLI-конвертера, превращая хранилище заметок Obsidian в структурированную электронную книгу EPUB со ссылками и иллюстрациями.

Что нужно для отрисовки диаграмм Mermaid в EPUB?

В системе должен быть установлен CLI-пакет Mermaid через npm install -g @mermaid-js/mermaid-cli.

Исходный текст

SKILL.md · MIT
---
name: obsidian2epub
description: Convert Obsidian vaults to EPUB ebooks. Use when the user wants to create an ebook from Obsidian notes, export a vault as EPUB, or convert markdown notes to an ebook format.
---

# Obsidian2Epub

Convert Obsidian vaults to well-structured EPUB ebooks with full support for wikilinks, attachments, and Mermaid diagrams.

## Quick Start

```bash
scripts/convert.sh /path/to/vault -o output.epub
```

## Instructions

1. Get the vault path from the user
2. Determine output EPUB path
3. Ask about optional settings (title, author, theme, filters)
4. Run the conversion using `scripts/convert.sh`
5. Report any warnings (unresolved links, mermaid failures)

## CLI Reference

```bash
# Basic conversion
scripts/convert.sh /path/to/vault -o book.epub

# With options
scripts/convert.sh /path/to/vault \
  -o book.epub \
  --title "Book Title" \
  --author "Author Name" \
  --moc "Index.md" \
  -d  # dark Flexoki theme

# Interactive TUI
scripts/convert.sh --tui
```

## Options

| Option | Description |
|--------|-------------|
| `-o, --output` | Output EPUB path (required) |
| `--title` | Book title (default: vault name) |
| `--author` | Author name |
| `--moc` | MOC file for chapter ordering |
| `-d, --dark` | Dark Flexoki theme |
| `--include` | Regex to include files |
| `--exclude` | Regex to exclude files |
| `--tui` | Launch interactive TUI |

## Features

- **Wikilinks**: `[[note]]` becomes internal EPUB links
- **Mermaid**: Rendered to SVG (requires `npm install -g @mermaid-js/mermaid-cli`)
- **Smart Ordering**: HITS algorithm for chapter order
- **Flexoki Themes**: Light (default) and dark

## Examples

Convert with custom title:
```bash
scripts/convert.sh ~/Obsidian/MyVault -o mybook.epub --title "My Knowledge Base"
```

Include only specific folders:
```bash
scripts/convert.sh ~/Obsidian/MyVault -o book.epub --include "^Projects/"
```

Exclude drafts:
```bash
scripts/convert.sh ~/Obsidian/MyVault -o book.epub --exclude "^Drafts/"
```

## Configuration

Set `OBSIDIAN2EPUB_DIR` environment variable to override the default installation path:

```bash
export OBSIDIAN2EPUB_DIR=/path/to/obsidian2epub
```

## Troubleshooting

**Mermaid not rendering**: Install mermaid-cli: `npm install -g @mermaid-js/mermaid-cli`

**Unresolved wikilinks**: Links to notes not in vault are reported as warnings

**Missing attachments**: Ensure files exist and paths are correct in notes

© Unintendedsideeffects · MIT · Unintendedsideeffects/Skills-And-Agents

Похожие скиллы

Все скиллы по теме «Заметки, задачи и проекты» →
obsidian-notes-creator szeyu Скилл obsidian-notes-creator создаёт, дополняет и проверяет учебные заметки Obsidian по лекциям, учебникам и PDF-файлам. Форматирует конспекты с LaTeX-формулами, диаграммами Mermaid и подробными решениями задач. CX Codex +1 689установок book-converter bmad-labs Скилл book-converter для Claude Code переводит электронные книги EPUB в чистый Markdown с выверенной структурой. Превращает разрозненный текст из читалок в готовые главы и общее оглавление. CX Codex +1 147установок markdown-to-epub-converter smerchek Скилл markdown-to-epub-converter для Claude Code собирает из Markdown готовую книгу EPUB3 с оглавлением и главами. Работает и в Codex, Cursor, Copilot, Gemini CLI и OpenCode. CX Codex +1 725установок epub aliceisjustplaying Извлекает главы, оглавление и текст электронных книг EPUB в формате Markdown. Помогает изучать книги и искать цитаты прямо через диалог с агентом. CX Codex +1 5установок wiki-lint Ar9av Скилл wiki-lint проверяет здоровье базы Obsidian: находит битые ссылки, страницы-сироты, пропуски во фронтметтере и устаревшие заметки без полного чтения всех файлов хранилища. CX Codex +1 3 600установок wiki-update Ar9av Скилл wiki-update синхронизирует архитектурные решения и контекст проекта в базу знаний Obsidian. Помогает сохранить выводы и структуру связей между кодом и заметками. CX Codex +1 3 400установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой