Skip to content

Home

Jump to bottom
David edited this page May 31, 2026 · 2 revisions

Semantic Reading Wiki

Mark prose with semantic sigils. Turn the tags into a vault-wide knowledge graph, a spaced-repetition queue, and AI-synthesized study guides.

This wiki is the deep-dive companion to the README. The README explains what the plugin does and how to install it; the wiki explains how each piece works so you can pick the parts that fit your workflow.

Reading order

If you're new, this order works well:

  1. Inline Syntax — the {{Tag|text}} grammar that everything is built on.
  2. Tag Taxonomy — the 19 built-in sigils, their semantic families, and the encoding frameworks they route to.
  3. Domain Profiles — swap the tag toolkit per note. Add semantic_domain: programming (or bible, science, legal, meeting) to surface domain-specific sigils.
  4. Settings Reference — every panel, every field, every default.
  5. Integrations — the eight one-button hooks (Anki, Dataview, Tasks, ICS, Mermaid/Canvas, Readwise/Kindle, daily-note injection, MCP).

If you're integrating from another tool or building on top:

  • Public API — app.plugins.plugins['semantic-reading'].api. Stable across minor versions.
  • MCP Server — JSON-RPC over HTTP for Claude Desktop / Cursor / VS Code / any MCP client.
  • Troubleshooting — debugging tips, including how to attach Electron's CDP when something looks off.

Tag-at-a-glance

Family Sigils What it captures
Anchor N D P Named entities — people, dates, places.
Meaning Def Mn Ex An Q Concepts and the questions about them.
Structure R Ev C B L T X Opp Assump Relations, evidence, constraints, tradeoffs, tensions.
Execution A M Actions to take and measures to check them by.

Each tag routes to one of five encoding frameworks (NEDF, CAST, SPEAR, HEART, ORACLE) — see Tag Taxonomy for the full breakdown.

License + contributing

MIT. Issues, PRs, and discussion welcome at the main repo.

Clone this wiki locally