README file from
GithubHiLighter - Obsidian Highlight Note Management Tool
HiLighter - Obsidian 高亮笔记管理工具
HiLighter is an Obsidian plugin focused on highlight note management. It transforms highlighted content into manageable note cards with support for multiple color annotations, AI-powered analysis, and intelligent search features, making your note organization more efficient. Works across Markdown, PDF, and EPUB.
HiLighter 是一款专注于高亮笔记管理的 Obsidian 插件。它将高亮内容转化为可管理的笔记卡片,支持多色标注、AI 智能分析与智能搜索,让笔记整理更加高效。支持 Markdown、PDF 与 EPUB。
🌐 Languages / 语言: English | 简体中文 | 日本語 | 한국어 | Français | Deutsch | Español | Português | Русский

✨ Core Features
🎨 Highlight Note Cards Management
- Sidebar Management: Aggregates
<mark>highlighted content from current document or entire library, supporting instant navigation to original text via card click. - Multi-Dimensional Filtering:
- Color Filter: Quick categorization by four highlight colors: yellow, pink, blue, and green.
- Keyword Search: Real-time filtering of note content via top search bar.
- AI-Powered Intelligence:
- AI Translation (Languages): One-click precise translation of highlighted sentences.
- Sidebar AI Chat: Connect a configured model, select one or more cards as context, and ask a question or choose a built-in or custom research prompt. Save a reply as a new idea card linked to the cards used for that request. Send with the arrow or Enter; use Shift+Enter for a new line.
- Flexible Interaction:
- Quick Edit: Click a card's note area to edit it; the detail editor saves changes automatically and renders Markdown when editing ends.
- Tag System: Support for custom tags with built-in intelligent recommendation algorithm.
- Card Collection Navigation: One-click switch to full-screen "Card Studio" mode for centralized inspiration management.
- Note Card Management:
- Locate Original Text: Click a card to instantly jump to the highlighted position in the source note for quick context recovery.
- Classification Tags: Add tags to each card for organized categorization, with support for batch tag operations.
- Batch Deletion: Enter batch mode to multi-select cards and delete them in one click for efficient cleanup.
- Card Hierarchy: Drag a card onto the upper area of another card to nest it, or onto its lower edge to place it immediately after that card at the same level. Move several selected cards together; same-document hierarchies support up to three levels. Drop into empty list space to move back to the top level.
- Live Card References: Drag a sidebar card into a Markdown note to insert a reference that displays the latest card content. The embedded card can open its editor or remove the reference.
- Dictionary and Translation: Select text and use the lookup icon to see dictionary definitions above the translation. Chinese entries use Wiktionary and English entries use Free Dictionary API; pronunciation uses an available local system voice.

📄 PDF Annotation (New in 2.5)
- Highlight inside PDFs: Select text in any PDF and pick a color — a translucent highlighter mark appears on the page and a note card is created instantly, with your notes, tags, flashcard review and mind maps working exactly like markdown highlights.
- Persistent marks: Every highlight is anchored to page geometry, so marks survive page turns, closing and reopening the file, zooming, and vault syncs across devices.
- Two-way sync with cards: Delete a card and its PDF mark disappears immediately; recolor a card and the mark updates instantly.
- Jump to the exact sentence: Click a card to scroll straight to the highlighted sentence in the PDF, with a brief locate flash.
- Capture a region: In the PDF reader, use the selection toolbar or
Ctrl/Cmd+Shift+9to select a region and create an image note card. For scanned PDFs,Ctrl/Cmd+Shift+Hopens the toolbar without selecting text. Both shortcuts can be changed in Obsidian's hotkey settings.

📖 EPUB Reading & Highlights (New in 2.6)
- Read epubs in your vault: Click any
.epubfile to open it in the HiLighter reader (turn on "Detect all file extensions" under Settings → Files & Links so epubs appear in the explorer, or use the Open EPUB book command). Your reading position is remembered per book. - Highlight & take notes: Select text and highlight in four colors with the same menu — AI translation and research included. Marks are CFI-anchored, so they survive reopens, page turns, and vault sync; deleting or recoloring a card updates the book page instantly.
- Cards locate the source: Every highlight becomes a note card; click it to jump back to the exact sentence with a locate flash.
- Reader toolbar: outline dropdown for chapter jumps, page jump with auto-generated page numbers, and bookmarks (add the current page, jump back from the list, remove anytime).
- Two reading modes: horizontal page turns (buttons or left/right swipe) or continuous vertical scrolling — switch anytime; your position is preserved.
- Display settings (New in 2.8.2): The
Aatoolbar button opens the reader's display panel. Pick a page color — five light papers and six dark background/text pairings (sepia, blue, green, warm-ink…) — then fine-tune font size, line height, and page margins with steppers, and choose from 16 CJK and latin fonts (Song, Kai, Fangsong, Yuan, Baskerville, Palatino, Iowan Old Style, Charter, Garamond…). Everything applies live and is remembered across books.

🧠 Mind Maps (New in 2.4)
- One-Click Generation: Import all highlights from any file as a mind map — grouped by document headings, highlight color, tag, or flat order.
- Card Layout and Hierarchy: Nodes use card-style layouts with rendered Markdown. Collapse card details in one click, switch between selection and hand tools, and jump from a linked card to its source. When source cards have a hierarchy, imports use that hierarchy.
- Xmind-Style Editing: Drag topics to re-parent or reorder, Tab/Enter/Delete shortcuts, double-click inline editing, collapse/expand branches, undo/redo, and associative lines between any two topics.
- 9 Structures: Balanced mind map, logic diagram (right/left), organization chart, horizontal/vertical timelines, fishbone, and catalog organization — switchable at any time.
- 6 Style Themes × 8 Color Palettes: Line shapes and widths (curves, straight, rainbow branch lines) combined with full color schemes (background, node fill/border with per-level fading borders, plus a colorful card-colored option).
- Summaries & Notes: Box topics with summary nodes, attach your notes to any topic, and jump straight back to the source highlight.
- Import & Export: Open
.xmindfiles directly; export to PNG,.xmind(re-openable in Xmind), a Markdown outline, or an Obsidian.canvasboard.

⚡ Flashcard Review (FSRS)
- Spaced Repetition: Built-in FSRS scheduling turns highlight cards into flashcards with a due queue and per-card review status.
- Focused Review Session: Flip cards with Space, rate recall 1–4 (Again/Hard/Good/Easy), skip or archive — all keyboard-driven.
- Review Insights: Due/new counts on the studio toolbar, plus review statistics in the stats dashboard.
📚 Bookshelf Navigation
- One home for everything: A bookshelf icon in the ribbon opens the HiLighter bookshelf — a navigation page with five tabs: Recent reading, Books, Notebooks, Mind Map, and Stats. The card studio, theme switching and the light/dark toggle live in the top bar too; the card studio stays focused on card management.
- Recent reading: Files that recently received highlights — markdown, PDF, and EPUB — as a cover grid with per-file highlight counts, newest activity first. Click a book to open it where you left off.
- Books: A calibre-style shelf of every EPUB / PDF / Markdown file inside your scan scope. Configure any number of include folders plus exclusions; switch between large covers, small covers, and a list view, and sort by title, recent highlights, or file modification.
- Custom shelves: Save any scan scope under a name — then the toolbar's shelf button opens a dropdown where one click switches the whole library to that shelf. "Add shelf" at the bottom of the dropdown opens the full scope editor (include / exclude folders, per-folder recursion, saved-shelf management).
- Book & File Management: Search books by title, filter by format (EPUB / PDF / Markdown) or tag, and paginate large libraries (20/50/100/200 per page). Tag any book for categorization, multi-select books for batch tagging, and trash-delete stale files in one click.
- Drag-and-Drop Import: Drag external EPUB / PDF / Markdown files straight into the shelf — HiLighter copies them into your vault automatically, ready to read and highlight.
- Covers everywhere: EPUB covers and titles/authors are read straight from the book files (including
cover.xhtmlwrapper pages); PDFs render their first page; markdown notes use acover/image/banner/featured/thumbnailfrontmatter property — a vault image in any link spelling or a network URL — and fall back to a generated cover. Everything loads lazily and is cached. - Stats without leaving the shelf: The stats tab shows the full statistics dashboard.

📓 Notebooks (New in 2.9)
- A notebook for every book: The Notebooks tab gives each book or article with highlights its own notebook, with a patterned cover — plaid, floral, watercolor, geometric, dots, stripes, grid, terrazzo, marble, denim, kraft, constellation — and the book title on the front. Click a notebook to read all its highlights and notes in document order.
- Personalize: Right-click a notebook to rename it, swap its cover (12 built-in patterns, or your own images dropped into the plugin's
covers/folder), or export the whole notebook to Markdown in your configured card folder — quotes and notes together, no extra headings. - Read and annotate: Each entry pairs the highlighted passage with your note. Click a note to edit it in place — a clean, chrome-free input that saves silently — and use the locate button to jump back to the exact spot in the book.
- Per-entry actions: Every entry's icon buttons save that single entry as Markdown or open the quote card editor. Search, sort and format filters work across notebooks, and long lists get a back-to-top button.

🎴 Quote Cards (New in 2.9)
- Turn any highlight into a shareable image: The image icon on a notebook entry opens a full-height quote card editor with a live preview — rendered quote, your note beneath it, and the book title in the footer.
- Typography controls: Font size, 18 Chinese and Latin fonts (Song, Kai, Fangsong, Yuan, Lishu, Xingkai, Georgia, Didot, Baskerville, Futura, typewriter, handwriting…), three layouts (centered / left-aligned / big quote), five aspect ratios (3:4, 4:3, 1:1, 16:9, 9:16), plus margin, line-height and letter-spacing sliders, and text colors from presets or a custom picker.
- Backgrounds: 22 built-in backdrops, a custom color picker with solid or gradient fills (auto-tuned ink color by luminance), and image backgrounds — upload a local file or paste a network URL.
- Mask and light effects: Tune the overlay opacity, pick a mask color (black / navy / warm), add light effects — vignette, center light, top light, bottom fade — and blur the background image for readability. A reset button clears the mask in one click.
- Five watermark styles: highlighter stroke (the default), plain text, serif caption, stamp, and outline text. Download the card as a PNG with one click.

🚀 Quick Start
Installation
- Manual Installation (Recommended):
- Obtain the latest version's three main files:
main.js,manifest.json, andstyles.css. - Place them in your vault folder:
.obsidian/plugins/hilighter/. - Enable the plugin in Settings > Third-party plugins.
- Obtain the latest version's three main files:
- Community Plugins: Search for
HiLighterin Obsidian's Community Plugins browser and install it directly.
Basic Configuration
- AI model configuration: Configure a model in plugin settings to use AI translation and sidebar chat. Providers include DeepSeek, Google Gemini, and Volcano Engine (Ark); research prompts can also be customized there.
- Ribbon Icon: You can control whether to display the sidebar highlight notes icon in settings.
🤖 Agent Skill: Highlight a Whole Document with One Prompt
The optional pandora-hilight skill lets an AI agent (ZCode, Claude Code, …) process a note for you: it picks the highlight-worthy sentences, assigns colors by semantics (yellow = key idea, blue = concept, green = method, pink = quote), writes a study note for every highlight, and saves everything straight into HiLighter. The skill interacts in your language — ask about it in German and it guides (and annotates) in German.
Install — copy the block below and paste it to your agent:
Please install the pandora-hilight skill from https://github.com/PandoraReads/HiLighter:
1. Sparse-clone the repo: git clone --depth 1 --filter=blob:none --sparse https://github.com/PandoraReads/HiLighter /tmp/hilighter-repo && cd /tmp/hilighter-repo && git sparse-checkout set skills/pandora-hilight
2. Copy the skills/pandora-hilight folder into your own skills directory so the skill loads in future sessions.
3. Verify that SKILL.md exists with a valid frontmatter, clean up /tmp/hilighter-repo, and tell me how to trigger the skill.
After installing, just tell your agent "highlight this note" or run /pandora-hilight. Requires the HiLighter plugin installed in your vault; the skill writes highlights into the plugin's sync file (.hilighter/sync-data.json) and triggers the import automatically.
Prefer manual? One line:
git clone --depth 1 https://github.com/PandoraReads/HiLighter /tmp/hl && mkdir -p ~/.zcode/skills && cp -r /tmp/hl/skills/pandora-hilight ~/.zcode/skills/ && rm -rf /tmp/hl
🔄 Data Sync
HiLighter stores highlights in a per-device IndexedDB, but it can sync them across devices through a vault file (default .hilighter/sync-data.json). Enable Sync in settings and let iCloud or Obsidian Sync sync that file.
- Auto-import: the plugin watches the sync file and merges changes from other devices automatically (~30s poll + on window focus).
- Auto-export: local changes are exported back (debounced ~20s), merging the remote file first so you don't clobber other devices.
- Deletes propagate via lightweight tombstones (pruned after 30 days).
- Add/update only: sync merges rows but never deletes rows that were not explicitly tombstoned; it does not read Obsidian Sync's
*-conflicted-*copies.
You can still trigger sync manually with the Export to Vault / Import from Vault commands.
Deep links
obsidian://hilighter?op=... supports:
| op | action |
|---|---|
sync-import |
import from the sync file |
sync-export |
export to the sync file |
sync |
import then export |
open-studio |
open the Card Studio |
open-view |
open the highlight sidebar (add &side=main for the main area) |
Useful from iOS Shortcuts and other apps. Without a vault= parameter the URL targets the last-active vault.
🛠 Development & Build
Developers are welcome to contribute to improving this project!
- Requirements: NodeJS (v16+)
- Install Dependencies:
npm install - Development Mode:
npm run dev - Production Build:
npm run build
❤️ Support & Feedback
If you enjoy this plugin, you can show your support through:
- Follow Official Account: 潘多拉的数字花园 (Pandora's Digital Garden)
- Bilibili: Follow 潘多拉的数字花园 on Bilibili for video walkthroughs
- Multi-Platform Support: Also available on Weibo, Xiaohongshu (Little Red Book), and Knowledge Planet under the same name
- Contact & Feedback: Feel free to add VX: PandoraReads
☕ Buy Me a Coffee
If HiLighter saves you time, you can treat the developer to a coffee (scan with Alipay / WeChat):
Changelog
v2.9.0 (2026-11-17)
- Notebooks (new): A new bookshelf tab that turns every highlighted book or article into a notebook with a patterned cover — 12 built-in patterns (plaid, floral, watercolor, geometric, dots, stripes, grid, terrazzo, marble, denim, kraft, constellation) or your own images in the plugin's
covers/folder. Open a notebook to read all highlights and notes in document order; edit notes in place with a clean inline input; rename notebooks (the link to the book stays intact); export a whole notebook or a single entry to your card Markdown folder. - Quote cards (new): A full-height editor that renders any highlight as a shareable PNG — 18 CJK/Latin fonts, three layouts, five aspect ratios, margin/line-height/letter-spacing sliders, text color presets plus a custom picker, 22 backgrounds with custom solid/gradient colors and image backgrounds (upload or URL), mask overlays with opacity, color, light effects and background blur, and five watermark styles.
- Fixed the card studio's sort/filter/group dropdowns, which had stopped opening (a stylesheet rule was overriding their position), and the bookshelf back-to-top button after tab switches.
v2.8.3 (2026-11-11)
- Custom shelves for the library tab: save any scan scope under a name, then switch shelves from a dropdown on the toolbar — one click per shelf, with "Add shelf" at the bottom opening the full scope editor (include / exclude folders, per-folder recursion, saved-shelf management with delete confirmation).
v2.8.2 (2026-11-11)
- EPUB reader display panel (
Aabutton): page color presets — five light papers plus six dark background/text pairings — font size, line height and page margin steppers, and 16 CJK/latin fonts. All settings apply live and persist across books. - Bookshelf covers are resilient on tablets now: every cover read runs behind a timeout, so a stalled iCloud placeholder download can no longer freeze the whole shelf; oversized books fall back to generated covers instantly, and extracted covers are cached persistently — the cache syncs through iCloud, so a tablet reuses covers the desktop already extracted.
- Bookshelf: favorite books with hover hearts on covers plus a favorites-only filter; direct page jump in the pagination bar; compact toolbar/pager controls; the tablet light/dark toggle icon is always visible.
- Lookup popup: dictionary and translation results render as separated cards, with phonetics on their own line and a clearer layout.
v2.8.1 (2026-11-11)
- Bookshelf scan-scope hardening: per-folder recursion toggles, a 2000-file scan cap with a visible warning, and idempotent refreshes that stop iCloud sync churn from flickering the shelf. Fixed the buy-me-a-coffee image path in the language READMEs.
v2.8.0 (2026-11-10)
- Added the Bookshelf navigation page (desktop & tablet): a ribbon bookshelf icon opens one home for the plugin — Recent reading, Books, Mind Map and Stats tabs, a card-studio entry in the top bar, plus theme and light/dark controls (the card-studio topbar now focuses on reviewing).
- Recent reading lists every file that recently received highlights — markdown, PDF and EPUB — with per-file counts and one-click open. The Books tab scans configurable include/exclude folders in a calibre-style cover grid with large/small/list views, title search, format and tag filters, sorting, and pagination (20/50/100/200 per page).
- Covers come from the books themselves: EPUB built-in covers with titles/authors (epub.js first, zip-level parsing as fallback), PDF first pages (pdf.js warmed on demand), and markdown frontmatter
cover/imageproperties or network URLs. Everything loads lazily with caching; books without covers get a generated gradient card. - Books support tags with tag filtering, multi-select batch tagging, and batch trash-delete; external EPUB/PDF/Markdown files can be dragged straight into the shelf and are copied into the vault.
v2.7.0 (2026-10-30)
- Added sidebar AI chat with model switching, selectable card context, research prompt presets, and the ability to save answers as linked idea cards.
- Added card references in Markdown, card-to-card links, and drag-and-drop hierarchy for individual or multiple selected cards. Sidebar batch actions support tag changes and deletion.
- Added PDF region capture to image cards and a selection lookup popup with Chinese and English dictionary definitions, translation, and system pronunciation.
- Updated the card detail editor with automatic saving, Markdown preview, compact two-column layout, and linked-card controls; refined sidebar filtering and card presentation.
- Updated mind map nodes to card layouts with Markdown rendering, card-detail collapse, pointer/hand tools, source navigation, and imports that respect saved card hierarchy.
- Improved long-list scroll restoration, quote-card word wrapping, and EPUB error messaging.
v2.6.3 (2026-10-28)
- Card methods and links: add Cornell, one-page synthesis, and Luhmann-style idea card layouts with named cards, structured method fields, and links between related cards. Sidebar and Card Studio cards now render method content in dedicated layouts.
- Card Studio polish: refine card headers, metadata, editing, and floating actions; add compact icon-only controls and improve card grouping and sorting.
- Mind map editing: add free-positioned cards, multi-node selection, alignment and appearance controls, and a persistent floating action rail. Improve imported-map style switching and preserve map contents when changing palettes.
- Mind map toolbar: group the fit-to-canvas action with the compact-layout control for easier access.
- Data compatibility: extend local database and vault-sync merging for card methods, titles, and relations while retaining existing highlight cards.
v2.6.0 (2026-10-26)
- Bookmarks & reading modes: the reader toolbar gains bookmarks (bookmark the current page, jump back from the list, remove with one click) replacing the old resume button, and a page ⇄ scroll mode toggle — horizontal page turns (buttons or left/right swipe) or continuous vertical scrolling, with your position preserved across the switch and scroll updating the saved progress.
- EPUB reader toolbar: an outline dropdown (jump to any chapter), page jump (auto-generated page numbers with a slider and exact-page input, cached per book), and a "resume last reading position" button. Outline/page/card jumps never overwrite your saved reading spot, so resume always points where you actually left off.
- Card order: highlight cards for the current epub now follow the book's reading order (CFI position) instead of creation order; the studio's source-order sort uses the same comparator.
- EPUB reading & highlights (fixed): EPUB files in the vault now open in the HiLighter reader — the view previously stayed blank because it was not registered as a file view and never received the file. Select text to highlight in four colors, cards jump back to the exact sentence with a locate flash, and deleting or recoloring a card updates the book page instantly. A broken book now shows a readable in-view error with a retry button.
v2.5.1 (2026-10-25)
- AI model setup: Presets now prefill the whole form (only the API key is left to enter). A "Fetch model list" button pulls the live model IDs your key can actually use, and common product names (e.g.
deepseek-v3) are auto-corrected to real API model IDs. On a 400/404, the error message now lists the models available to your key. - Kimi fix: New Kimi keys only serve
kimi-*models (preset default is nowkimi-latest), and k2.6+ only accepts temperature 1 — each model can now set its own temperature in the editor. - AI explain: The text-selection toolbar gains an "AI explain" button that writes a short annotation straight into the note box. The full-text AI analysis panel was removed.
- Fixes: The preset picker is now scrollable, and the settings page keeps your scroll position after edits.
v2.5.0 (2026-10-25)
- PDF highlighting: Select text in any PDF, pick a color, and a translucent mark appears on the page while a note card is created. Marks are anchored to page-relative selection geometry, so they survive page turns, reopens, zooming, and vault syncs — independent of the PDF renderer's internals.
- Jump to the exact sentence: Clicking a PDF card scrolls to the highlighted sentence and flashes it for ~1.2s (previously page-level only).
- Two-way sync: Deleting a card removes its PDF mark immediately; recoloring a card updates the mark instantly.
- Fixes: Repaired a long-standing crash in PDF highlight capture (page anchors were never saved), an overlay repaint feedback loop, and custom highlight colors not tinting sidebar card stripes.
v2.4.1 (2026-10-24)
- Plugin directory fix: Reverted the manifest name to ASCII-only "HiLighter" (the community directory rejects non-ASCII names and hid the entry). The bilingual description is unchanged.
v2.4.0 (2026-10-24)
- Mind maps (new): A "Mind Map" entry in the card studio imports all highlights from a file as a mind map — grouped by document headings, color, tag, or flat — with Xmind-style editing: drag to re-parent, Tab/Enter/Delete shortcuts, collapse/expand, undo/redo, and associative lines between topics.
- Mind map structures & themes: Balanced/right/left logic layouts plus org chart, horizontal/vertical timelines, fishbone, and catalog structures; six style themes (line shapes, widths, rainbow branch lines, node shapes) and eight color palettes (background/line/border schemes with per-level fading borders, plus a colorful card-colored option).
- Mind map integration: Highlight cards stay linked to their nodes (edits re-sync, deleted cards are flagged), nodes can jump back to the source text, and maps auto-save with debounced persistence.
- Mind map import/export: Import
.xmindfiles (modern and legacy formats, first sheet); export to PNG,.xmind, a Markdown outline, or an Obsidian.canvasboard. - Markdown notes: Gallery cards and the enlarged card dialog now render note Markdown (with a write/preview toggle in the dialog).
- UI languages: Added Japanese, Korean, French, German, Spanish, Portuguese, and Russian (partial translations with English fallback), plus a "Follow Obsidian language" option.
- UI polish: Unified studio topbar typography and heights, palette icon on the theme selector, transparent scrollbars in the sidebar and studio, and a back-to-top button in the sidebar highlight list.
- Data: Mind map documents persist in IndexedDB (schema v5, additive — no migration needed).
v2.3.0 (2026-10-23)
- Card Studio: Added source-order sorting as the default, responsive card layout, consistent excerpt height, direct editing in the enlarged card dialog, and Markdown export for individual cards or full groups to a configurable vault folder.
- Themes and cards: Refined theme and light/dark styling; Ocean, Forest, Galaxy, Sunset, and Rose use color-dot accents instead of left color rails. Removed the “My Note” card label and refined color aliases, pin placement, and review status placement.
- Flashcard review: Improved card dimensions and text scale, with clearer review flow and rating states.
- Highlight notes: Added a note entry point to the selection toolbar, Cmd/Ctrl-click and double-click triggers, and note previews on highlight hover.
- Images and settings: Fixed image rendering while editing notes; added paste/drop image support and a configurable image folder.
- Studio tools: Added group export and a back-to-top control, and improved grouping/filter layout behavior.
"Let highlighted notes become the catalyst for inspiration." — HiLighter