内置 Markdown 阅读器

概述

插件内置了一个轻量级 Markdown 阅读器。当你在 Zotero 中双击任意 .md 附件时，会自动在内置阅读器中打开，无需跳转到外部应用。

阅读器默认开启。如需关闭（改回系统默认打开方式），可在 偏好设置 → 通用 中取消勾选。

功能

大纲导航

左侧边栏自动解析文档中的标题层级（h1-h4），点击可快速跳转到对应章节。

全文搜索

工具栏中的搜索框支持关键词搜索，命中处会高亮标记。

Markdown 渲染

• 代码块：highlight.js 语法高亮，支持主流编程语言
• 数学公式：KaTeX 渲染 LaTeX 公式，支持行内和块级
• 表格、列表、引用：标准 Markdown 语法完整支持
• 图片：相对路径图片自动加载

字号与宽度

• 字号调节：12px-24px 可调，点击工具栏 +/- 按钮逐步调整
• 阅读宽度：支持窄栏（860px）和宽栏（1160px）两种模式，适合不同屏幕

工具栏操作

按钮	功能
搜索框	全文关键词搜索
刷新	重新读取文件并渲染
复制 Markdown	将原始 Markdown 内容复制到剪贴板
复制路径	将文件路径复制到剪贴板
字号-	缩小字号
字号+	放大字号
宽度切换	切换窄栏/宽栏阅读模式
回到顶部	平滑滚动到文档顶部
系统打开	使用系统默认应用打开该文件

自动主题

阅读器自动适配 Zotero 的亮色/暗色主题，无需手动切换。

偏好设置

在 Zotero → 设置 → Zotero Agents → 通用 中：

• 启用内置 Markdown 阅读器：勾选后双击 .md 附件在内置阅读器中打开；取消勾选后恢复系统默认打开方式。

技术说明

• 渲染引擎：markdown-it + KaTeX + highlight.js
• 安全：内建 HTML 净化，剥离 script/style/iframe 等不安全标签和事件处理器
• 支持文件类型：.md、.markdown（通过扩展名和 MIME type 双重检测）