Finally finish what you read — and what you write: progressive reading digests your input, progressive writing turns it into finished drafts — a complete loop from reading to writing.
- ✍ Progressive writing — your material, queued to be written: send selected blocks from any document straight into a writing book, let the roller serve you one piece a day, finalize as you go, then compile the draft; a four-color structure tree shows at a glance how far the book has come. What you read becomes the raw material of what you write
- 📖 Two progressive modes — excerpt-based (pick the essence) and piece-based (slice the whole doc), so long reads get digested day by day
- ✂️ Text-splitting toolkit — sentence splitting, Enter-to-split, block merging, double-tap multi-select on mobile
- 🎴 Card-making pipeline — multi-line cloze, multi-line cards, word flashcards and Daily Card — make cards where you read
- 🗺 AI-drawn knowledge maps — let AI read the book and draw the relationship graph: people, concepts, events, evidence-anchored and jump-to-source; pan it, save your own views, export as image
- Writing books — create one with a name and an outline; each outline line becomes a slot, so you frame the skeleton before you write
- Three ways to feed slots — send selected blocks from any doc, pull from the excerpt pool, or push from the floating bar; material carries a source badge that jumps back to the original text
- One roller, two phases — reading books and writing books share the same scheduler: reading is content written by others queued to read; writing is your own material queued to write. Each phase gets its own status-bar flame (reading / teal writing), so writing never eats into your reading quota
- Piece management — split into new pieces, move material across pieces, finalize when done (reversible)
- Structure tree at a glance — writing books open the knowledge map too: green = finalized, theme color = has material, orange = gap, grey = container; nodes carry material and sub-chapter counts, click to jump straight to a slot, export as image
- Let AI structure it (MCP) — AI inventories where material sits and where the gaps are, proposes a skeleton and previews every step before touching anything; it can also break a model essay down into a reusable skeleton
- Recite link-up — send a whole book or a single piece into Recite Practice: type on the original to annotate, extract into exercises, close the original, write from memory and compare word by word
- Compile to draft (Pro) — turn finalized pieces into a standalone document in one click, from material to finished work; the everyday writing flow is free
- Excerpt-based progressive learning — select to excerpt; the essence goes into a day-by-day queue
- Piece-based progressive learning — the whole document is auto-sliced; read one piece a day
- Books from doc folders — turn a folder of articles into one book: reading order follows the file tree, pieces attach to their source article, reorder any time and progress self-corrects
- Volume splitting for giant docs — a 3-million-word tome? Split it into volume sub-docs first (right-click in the doc tree), then add as a folder book — daily portions stay fine-grained either way
- Sentence splitting (Pro) — split long paragraphs into blocks automatically
- Split block by pressing Enter — Enter splits, staying out of your way
- Merge blocks — combine multiple blocks into one
- Multi-line selection via double-tap on mobile — select paragraphs fast on phones
- Word highlighting with explanations — select a word, see the meaning instantly
- Word flashcards — turn new words into cards in one click
- Multi-line cloze deletion — cloze over multiple lines
- Multi-line card creation — batch-create Q&A cards
- Daily Card — one card a day, steady accumulation
- Display pinyin — annotate Chinese characters with pinyin
- Visit frequency — revisits too dense or too sparse? Three gears stretch or tighten the revisit curve (3→6→12→24→48 days by default) without resetting progress
- Notes to your future self — leave a note on anything you revisit; newest on top, and the latest note rides along with each review reminder
- 7-day calendar strip — the review plan panel shows the coming week: due counts, estimated minutes, overload colors; click a day to filter
- Zero-output auto-relax — a book with no excerpts and no cards for 30 days gets its revisit interval gently stretched, with a badge and one-click restore — transparent, never silent
One rule of thumb: the whole reading & writing loop is free — unlimited books, pieces, excerpts and views. Pro adds the automation layer: letting the machine do the repetitive splitting, extracting and converting, plus decorating your workspace.
| Domain | Free | Pro adds |
|---|---|---|
| 📚 Reading | Add books, daily piece rolling, fleet & dual-flame progress (reading & writing tracked separately), floating bar, excerpts, all views, physical volume split for huge books | Auto sentence splitting — books & excerpts sliced by sentence, no manual splitting |
| ✍️ Writing | Writing books, three ways to feed slots, piece management, moving pieces across books | Compile finalized pieces into a standalone draft, material to work in one step; extract notes (all / current piece / append to bottom) — gather them as you finish; one-click note-color strip & restore |
| 🎴 Cards | Word flashcards, cloze deletion, multi-line card creation, Daily Card, turning excerpts into review cards | AI word lookup — saving words is free; AI translation & example sentences are Pro |
| 📥 Collection | — | Collect selected content to a file (Shift+Alt+O), merging as you go |
| 🎨 Appearance | Native look — clean and distraction-free | Skin sets — a whole new look in one click |
Pro is ¥72, one-time — and it gifts Recite Practice Pro (¥10, yours for free): activate once, own both. Purchase & activation: plugin settings → order → paste the redemption code back in settings — it binds to your SiYuan account automatically.
- Open a long document, select the text you want to read, and click "Excerpt" on the floating bar — or run the command "Add current document to piece-based progressive reading" to slice the whole doc
- Run "Start today's reading" from the command palette, read today's portion, and page through
- To remember the good parts: select and cloze/make cards — review happens in SiYuan's built-in flashcard system
- Got something to write? Create a "new writing book" from the fleet panel to set up slots, send great material you come across straight into them, let the roller serve one piece a day, finalize as you go, then "compile to draft" in one click
- 📖 Documentation (Chinese, with GIFs & videos for every feature)
- 🎬 Hands-on Tutorial (Chinese, zero jargon — follow along to finish the "read → recall → review" loop in ~10 minutes, with GIFs & full videos for every step)
- 🤖 Connect AI to SiYuan (MCP) (Chinese) — let AI check your reading queue, reschedule reviews and sort out your writing books' structure; three-step setup for ZCode / Trae / CodeBuddy / Qoder
- 🙏 Acknowledgments
- 💬 QQ Group (Chinese) — feedback and feature requests
- 💬 Feishu Group (Chinese) — feedback and feature requests
- 📱 Scan to join:

- 📦 Source repository — what you see is what's compiled: release packages are built remotely by GitHub Actions from source
📊 SiYuan Marketplace: 32,000+ downloads
All released versions up to v3.19.0 remain under the MIT License. Starting with the next release, this plugin ships under a proprietary license (see LICENSE):
- Personal use stays free — nothing changes for individual users
- Redistribution, re-packaging and distributing modified copies are not allowed
- Removing or bypassing the activation check is not allowed
- Commercial use (charging users, paid services, use inside a company) needs written permission — reach out via the Feishu group or GitHub issues

