astro-reader 是一个轻量级的 PDF 阅读器组件。让你的数字杂志、技术文档和在线阅读平台保持一致的流畅体验，同时保留完整的源码控制和主题适配。
三个简单步骤，从安装到完美嵌入，让你的文档站具备专业级阅读体验。
一行指令，将阅读器能力注入你的 Astro 或 Starlight 项目。
在 Markdown 或 Astro 页面中，直接引入并指定 PDF 路径。
自动继承 Starlight 的深色/浅色模式，提供流畅的翻页、缩放与导航体验。
在速度、排版美观度和开发体验之间，找到最佳的 PDF 嵌入方案。
| 特性比较 | 传统 iframe / object | 第三方 SaaS 嵌入 | astro-reader ✨ |
|---|---|---|---|
| 打包体积与性能 | 依赖浏览器默认，性能不一 | 依赖浏览器默认，性能不稳定 | 极轻量，原生 Astro 优化 |
| 主题一致性 | ❌ 无法自定义，视觉突兀 | ⚠️ 有限支援 | ✅ 完美适配 Starlight 深/浅色模式 |
| 移动设备体验 | ❌ 缩放困难，容易跑版 | ⚠️ 取决于供应商 | ✅ 原生触控优化，流畅滑动 |
| 隐私与资料控制 | ⚠️ 本地档案，但无互动控制 | ❌ 需上传至第三方服务器 | ✅ 100% 本地渲染，资料完全自主 |
左侧是你的 Starlight 文件导航与內容，右侧（或内嵌区块）是 astro-reader 提供的沉浸式阅读体验。支持目录跳转、页面缩放和全屏模式。