EPUB Reader and Highlighter
Aria530 downloadsRead EPUB files inside Obsidian with persistent, color-coded highlights, notes, and Markdown export.
- Overview
- Scorecard
- Updates5
其他语言 / Other languages: 简体中文 · 繁體中文 · Italiano — 见 GitHub 仓库 / see the GitHub repo: https://github.com/okkio-31mon/epub-reader-highlighter
Read EPUB books directly inside Obsidian, mark them up with color-coded highlights and notes, and export everything to Markdown.
Features
- In-app EPUB reader — open any
.epubfile in your vault and read it without leaving Obsidian. - Scroll or paginated mode — switch between continuous scrolling and page-by-page reading; turn pages with the on-screen buttons or the ← / → arrow keys.
- Fixed page numbers (Apple Books style) — the whole book is pre-paginated in the background at your current window size and font, so the total page count stays fixed while you read and every page turn advances by exactly 1. "Calculating" shows briefly on first open; the result is cached and only recomputed when the window or font changes. Type a number in the page box to jump straight to that page; scroll mode shows a reading-progress percent instead.
- Reading position remembered — close the book (or quit Obsidian) and reopening returns you to the passage where you left off.
- Color-coded highlights — select text and pick a color from the popup, or press
Cmd/Ctrl+Shift+Hto highlight with the default color; the default color is remembered across sessions. - Notes on highlights — attach a comment to any highlight.
- Highlights panel — view every highlight in the current book with its page number, text, and note; jump back to the original location, edit notes, or delete.
- Copy as quote — copy the current selection, or all highlights at once, as
*page · time*+ quote blocks ready to paste into a note. - Undo —
Cmd/Ctrl+Zreverses the last highlight or deletion. - Reading themes — five built-in backgrounds plus an inline color picker (no OS dialog) for any custom color, adjustable font and font size; link colors adapt to the background for readability.
- Full-book search — find a keyword anywhere in the book and jump to any result.
- Markdown export — export all highlights, or just the ones you pick, to a Markdown note from the highlights menu.
- First-run guide — a one-time popup explains the toolbar icons; the same reference lives in the plugin's settings tab.
Installation
From the community store
Search for "EPUB Reader and Highlighter" in Settings → Community plugins → Browse, install, and enable.
Manual
- Download
main.js,manifest.json, andstyles.cssfrom the latest release. - Copy them into
<your-vault>/.obsidian/plugins/epub-reader-highlighter/. - Reload Obsidian and enable the plugin in Settings → Community plugins.
Usage
- Place an
.epubfile anywhere in your vault and click it to open. - Select text to highlight — click a color in the popup, or press
Cmd/Ctrl+Shift+Hfor the default color. - Click an existing highlight to add or edit a note.
- Use the toolbar to browse the table of contents, copy a quote, open the highlights menu, adjust the font and background, turn pages, and search the book.
Toolbar icons
| Icon | What it does |
|---|---|
| ☰ (menu) | Table of contents — browse the chapters and jump to one. |
| 〝 (quote) | Copy quote — copy the selected text as a *page · time* + quote block. |
| ▮ (highlighter) | Highlights menu — open the highlights list, copy all, export (all or selected), and set the default highlight color. |
| ≡ (sliders) | Reading settings — font, text size, and background; the color wheel expands an inline picker for any custom color. |
| Scroll / Paged | Switch between continuous scrolling and page-by-page reading. |
| ‹ page › | Previous / next page (← / → work too). The page box shows the fixed page / total · percent — type a number and press Enter to jump; in scroll mode it shows the progress percent. |
| 🔍 | Search — find a keyword anywhere in the book and jump to a result. |
| ⋯ | More — interface language and the quick guide. |
Shortcuts: Cmd/Ctrl+Shift+H highlight the selection · Cmd/Ctrl+Z undo.
Highlights, reading positions, and preferences are stored in this plugin's data.json inside your vault and never leave your machine.
Development
npm install
npm run dev # watch build
npm run build # production build
Credits
EPUB rendering is powered by epub.js.
License
HealthExcellent
ReviewSatisfactory
About
Read EPUB files directly inside Obsidian with scroll or paginated views and adjustable reading themes. Highlight text in multiple colors, attach notes to highlights, browse or jump to highlights in a panel, and export all highlights (page, text, note) to a Markdown note.Details
Current version
0.2.1
Last updated
4 weeks ago
Created
Last month
Updates
5 releases
Downloads
530
Compatible with
Obsidian 1.4.0+
Platforms
Desktop only
License
MIT