← 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.

Read the Docs vs SiYuan: at a glance

FeatureRead the DocsSiYuan
SectorCollabCollab
Velocity score5.05.0
Sparks · 30d00
Top themesdocumentation-hosting, github-app, build-tooling, dependenciesnote-taking, knowledge base, ai agent, databases
Last editorial update1mo ago23h 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 3.8.9 reaches RC, adding AI-agent extraction of images embedded in PDFs.

SiYuan moved 3.8.9 from beta.6 to rc.1 on Oct 28. The RC's only new item is AI-agent extraction of images embedded in PDFs; the rest of its long list matches beta.5's cumulative notes: pinned agent sessions, backlink filtering by database fields, block-reference collection through database automation, resizable table rows, mind-map themes and node copy/paste, TIFF previews and macOS proxy detection.

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
5.0

SiYuan 3.8.9 reaches RC, adding AI-agent extraction of images embedded in PDFs.

◆ Current state

SiYuan moved 3.8.9 from beta.6 to rc.1 on Oct 28. The RC's only new item is AI-agent extraction of images embedded in PDFs; the rest of its long list matches beta.5's cumulative notes: pinned agent sessions, backlink filtering by database fields, block-reference collection through database automation, resizable table rows, mind-map themes and node copy/paste, TIFF previews and macOS proxy detection.

◆ Where it's heading

The 3.8.x line keeps turning databases and mind maps into structured tools that act on the block graph, and the built-in agent is gaining reach into document content such as PDFs. The release cadence is fast and noisy, with most builds repeating the same cumulative notes.

◆ Prediction

A stable 3.8.9 is likely within days, with little added beyond fixes now that it has reached RC.

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. 1d agoSiYuanSiYuan 3.8.9 RC1: AI agent extracts images from PDFs
  2. 1d agoSiYuanSiYuan 3.8.9 beta 6 (same notes as beta 5)
  3. 1d agoSiYuanSiYuan 3.8.9 beta 5: full notes incl. pinned agent sessions
  4. 2d agoSiYuanSiYuan 3.8.9 beta 4 improves LaTeX paste and import
  5. 2d agoSiYuanSiYuan 3.8.9 beta 3 (same notes as beta 1)
  6. 2d agoSiYuanSiYuan 3.8.9 beta 2 (same notes as beta 1)
  7. 1mo agoRead the DocsDocs edits, dependency bumps and a quieter GitHub App
  8. 2mo agoRead the DocsRate-limited GitHub syncs no longer delete repositories
  9. 2mo agoRead the Docshas_valid_clone made nullable before removal; tooling bumps
  10. 2mo agoRead the DocsBuild status skipped for commit-less builds; uv venv path fix
  11. 2mo agoRead the DocsIsolated builders gain private-repo support and uv installs
  12. 3mo agoRead the DocsDependency-only maintenance release

Frequently asked questions

What is the difference between Read the Docs and SiYuan?

They serve adjacent needs but don't currently overlap on shipped themes. Read the Docs and SiYuan are shipping at a similar cadence (velocity 5.0 vs 5.0, both within Sparkpulse's "active" band). 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. Read the Docs and SiYuan are shipping at a similar cadence (velocity 5.0 vs 5.0, both within Sparkpulse's "active" band). 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.