Repository navigation
首个公开版本,为 Codex 提供本地 Markdown 只读预览。
阅读与预览
- 支持
.md和.markdown,包含表格、任务列表、代码语法高亮、KaTeX 数学公式和 Mermaid 图表。 - 提供标题目录、阅读与源码视图切换、选区复制,主题自动跟随系统。
- 保存当前 Markdown 后自动更新正文、源码和目录,并保留阅读位置、源码视图和目录设置。
- 可在默认浏览器打开同一文档,适合分屏阅读;浏览器预览也会跟随文件保存自动刷新。
- 支持文档内标题跳转、本地图片,以及本地文件和外部链接;具体行为见兼容性说明。
安装与分发
- 提供 Codex 自建插件市场,市场包携带运行依赖;也可通过 macOS / Linux 和 Windows 安装脚本从源码安装。
- 提供 GitHub Release 源码归档、SHA-256 校验文件和远程安装脚本,支持固定版本安装。
- 安装时执行 MCP 自检,并提供失败后的恢复提示。
使用要求
- 需要 Node.js 22.12.0 或更新版本,以及支持插件和文件查看器的 Codex;各安装方式所需工具见安装说明。
- 预览只读,不会写回 Markdown 文件。本地图片仅从文档目录及其子目录读取,外部图片以说明文字替代。
- 自动刷新需要宿主提供相应能力;无法使用时会显示提示。刷新仅包含已保存的 Markdown 内容。
- 浏览器阅读期间需保持当前 Codex 聊天开启;插件更新后请重新打开预览。
下载文件
| 文件 | 用途 |
|---|---|
markdown-preview-v0.1.0.tar.gz / .zip |
源码及安装脚本,安装时下载运行依赖 |
SHA256SUMS |
两份源码归档的 SHA-256 校验值 |
markdown-preview-marketplace.tgz |
携带运行依赖的自包含市场包 |
marketplace.SHA256SUMS |
市场包的 SHA-256 校验值 |
安装方式见README。远程安装脚本支持固定 v0.1.0,默认解析最新正式 Release 后固定该标签下载并校验。
验证记录
-
PR #9 经 5 项 CI 通过后合并:Node.js 22.12.0 / 24.x 源码测试,以及 Linux / macOS / Windows 发行物安装验证。
-
本页附件来自 v0.1.0 发布工作流,源码提交为
1271c8e5cbd30ce8f1c0a343ae63811771546416。 -
发布后已验证公开附件下载及校验和,并在 macOS 的隔离 Codex 环境完成固定
v0.1.0、默认latest的真实远程安装,以及旧市场版本到本版本的升级;最终缓存的 MCP、页面资源和 Markdown 渲染均通过。
维护说明
本版本保留现有锁定依赖。生产依赖审计仍报告服务层 8 项、renderer 38 项既有上游告警;本次版本整理没有新增公告,也未修复这些告警。