← Back to home
Comparison · Collab

Read the Docs vs SiYuan

A side-by-side editorial comparison of Read the Docs and SiYuan — release velocity, themes, recent moves, and the top alternatives to consider.

Shared themes:open-source

Read the Docs vs SiYuan: at a glance

FeatureRead the DocsSiYuan
SectorCollabCollab
Velocity score5.06.3
Sparks · 30d01
Top themesdocumentation-hosting, github-app, build-tooling, dependenciesanthropic-api, ai-agents, mind-map, local-first
Last editorial update17d ago2h ago
WebsiteVisit →Visit →

What is Read the Docs?

Read the Docs ships a dated release every week, and this one is documentation and dependencies

Read the Docs cuts a date-versioned release most weeks, each a generated list of merged pull requests. Recent substance has been in two areas: the GitHub App integration, where rate-limit handling stopped deleting repositories and commit-status errors no longer raise spurious notifications, and the build environment, where isolated builders gained private-repo support and uv-based installs. Around that, a steady flow of dependency bumps and documentation edits.

Read the full Read the Docs trajectory →

What is SiYuan?

SiYuan ships Anthropic Messages API and editable mind maps as it builds an AI-native block notebook.

SiYuan is a local-first, open-source personal knowledge management tool built on a block-based data model, releasing multiple builds per week across alpha, beta, and stable tracks. The v3.8.4 beta cycle shipped a substantial agentic surface — streaming Markdown preview for agent responses, remote kernel plugin loading, and database field configuration via agent — while v3.8.5 alphas added direct Anthropic Messages API support and an editable mind map view for list blocks. The product simultaneously maintains aggressive mobile (iOS, Android, HarmonyOS) parity and sync reliability across local and cloud storage backends.

Read the full SiYuan trajectory →

Read the Docs vs SiYuan: editorial side-by-side

R5.0

Read the Docs ships a dated release every week, and this one is documentation and dependencies

◆ Current state

Read the Docs cuts a date-versioned release most weeks, each a generated list of merged pull requests. Recent substance has been in two areas: the GitHub App integration, where rate-limit handling stopped deleting repositories and commit-status errors no longer raise spurious notifications, and the build environment, where isolated builders gained private-repo support and uv-based installs. Around that, a steady flow of dependency bumps and documentation edits.

◆ Where it's heading

The GitHub App work is the thread worth watching — the project is hardening the path where it syncs a user's repositories, and the fixes have been about failing safely when GitHub throttles rather than about new capability. Build tooling continues to move toward uv. On the documentation side, the supported-tools list keeps widening, with Starlight added and Zensical's introduction reworked, which tracks the platform's shift away from being Sphinx-shaped.

◆ Prediction

Documentation keeps naming new generators before the platform's own tooling catches up to them, so expect build-side support work for the non-Sphinx generators the docs now list.

S
SiYuan
COLLAB
6.3

SiYuan ships Anthropic Messages API and editable mind maps as it builds an AI-native block notebook.

◆ Current state

SiYuan is a local-first, open-source personal knowledge management tool built on a block-based data model, releasing multiple builds per week across alpha, beta, and stable tracks. The v3.8.4 beta cycle shipped a substantial agentic surface — streaming Markdown preview for agent responses, remote kernel plugin loading, and database field configuration via agent — while v3.8.5 alphas added direct Anthropic Messages API support and an editable mind map view for list blocks. The product simultaneously maintains aggressive mobile (iOS, Android, HarmonyOS) parity and sync reliability across local and cloud storage backends.

◆ Where it's heading

SiYuan is trending toward a programmable AI-native notebook where the AI operates inside the knowledge graph rather than beside it. The agent dock, skill file management, remote kernel loading, and now direct Anthropic API support together form a layer where an AI agent can read, write, and reconfigure the workspace without external tooling. The v3.8.x cycle suggests the team is betting on in-graph agents over the simpler assistant-in-a-sidebar approach taken by most knowledge tools.

◆ Prediction

The most likely next step is a stable release that ships the Anthropic integration alongside the agent database configuration, then a push to expose block-level read/write APIs to the agent so it can make structural edits to the knowledge graph — turning SiYuan from a query target into an AI-editable workspace.

Alternatives to Read the Docs and SiYuan

Other Collab products tracked by Sparkpulse, ranked by recent ship velocity. Each card links to a full editorial trajectory and lets you pivot into a head-to-head comparison with either Read the Docs or SiYuan.

See all Read the Docs alternatives → · See all SiYuan alternatives →

Recent activity from Read the Docs and SiYuan

Latest ship moves from both products, interleaved chronologically. ⚡ = editorial spark.

  1. 11h agoSiYuanSiYuan v3.8.5 alpha: Mobile nav fixes and sub-document duplication
  2. 22h agoSiYuanv3.8.5-alpha.3
  3. 1d agoSiYuanSiYuan adds Anthropic Messages API and editable mind map for list blocks
  4. 1d agoSiYuanv3.8.5-alpha.1
  5. 3d agoSiYuanSiYuan v3.8.4 beta: Agent surface, remote kernels, and MiniMax image generation
  6. 3d agoSiYuanSiYuan v3.8.4 beta: Agentic database config and remote kernel plugin loading
  7. 18d agoRead the DocsDocs edits, dependency bumps and a quieter GitHub App
  8. 24d agoRead the DocsRate-limited GitHub syncs no longer delete repositories
  9. 1mo agoRead the Docshas_valid_clone made nullable before removal; tooling bumps
  10. 1mo agoRead the DocsBuild status skipped for commit-less builds; uv venv path fix
  11. 1mo agoRead the DocsIsolated builders gain private-repo support and uv installs
  12. 1mo agoRead the DocsDependency-only maintenance release

Frequently asked questions

What is the difference between Read the Docs and SiYuan?

Both compete on the same themes — open-source — within Collab. SiYuan is currently shipping more aggressively (velocity 6.3 vs 5.0), with 1 editorial sparks in the last 30 days against 0. See the at-a-glance table above for a side-by-side breakdown of velocity, recent sparks, and editorial themes.

Is Read the Docs better than SiYuan?

Sparkpulse doesn't pick a winner — we score release velocity, not feature parity. SiYuan is currently shipping more aggressively (velocity 6.3 vs 5.0), with 1 editorial sparks in the last 30 days against 0. For your specific use case, the alternatives sections above list other Collab products to evaluate alongside.

What are the best alternatives to Read the Docs?

Top Read the Docs alternatives in Collab are ranked by recent ship velocity. Browse the "Read the Docs alternatives" section above for the current picks, or visit /alternatives/read-the-docs for the full list with editorial commentary on each.

What are the best alternatives to SiYuan?

Top SiYuan alternatives in Collab are ranked by recent ship velocity. Browse the "SiYuan alternatives" section above for the current picks, or visit /alternatives/siyuan for the full list with editorial commentary on each.