# obsidian2epub

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

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 1 установка
- Автор: Unintendedsideeffects
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/Unintendedsideeffects/Skills-And-Agents/tree/HEAD/skills/obsidian2epub/SKILL.md
- Обновлён: 2026-04-09
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/obsidian2epub

## Что делает

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

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

## Требования
- Работает с: Obsidian

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Unintendedsideeffects/Skills-And-Agents --skill obsidian2epub -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/obsidian2epub/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/obsidian2epub/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Unintendedsideeffects/Skills-And-Agents --skill obsidian2epub -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/obsidian2epub/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Unintendedsideeffects/Skills-And-Agents --skill obsidian2epub -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/obsidian2epub/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Unintendedsideeffects/Skills-And-Agents skills/obsidian2epub
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/obsidian2epub/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Unintendedsideeffects/Skills-And-Agents --skill obsidian2epub -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/Unintendedsideeffects/Skills-And-Agents --path skills/obsidian2epub
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/obsidian2epub/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add Unintendedsideeffects/Skills-And-Agents --skill obsidian2epub -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/Unintendedsideeffects/Skills-And-Agents/tree/HEAD/skills/obsidian2epub/SKILL.md

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

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

## Похожие
- [obsidian-notes-creator](https://affpapa.org/nevibecode/skills/obsidian-notes-creator.md) — скилл · 689 установок
- [book-converter](https://affpapa.org/nevibecode/skills/book-converter.md) — скилл · 147 установок
- [markdown-to-epub-converter](https://affpapa.org/nevibecode/skills/markdown-to-epub-converter.md) — скилл · 725 установок
- [epub](https://affpapa.org/nevibecode/skills/epub.md) — скилл · 5 установок
- [wiki-lint](https://affpapa.org/nevibecode/skills/wiki-lint.md) — скилл · 3600 установок
- [wiki-update](https://affpapa.org/nevibecode/skills/wiki-update.md) — скилл · 3400 установок

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
