MarkWeb

一个本地优先、轻量的 Tampermonkey 网页笔记脚本。选中文字即可高亮和添加备注，刷新页面或重启电脑后仍能恢复；无需账号，也不会把笔记上传到网络。

当前版本：1.15.0

安装 MarkWeb

主要功能

• 六色网页高亮，支持自定义每个颜色槽。
• 右侧笔记面板集中管理当前网页的标注和备注。
• 点击卡片定位原文，双击卡片复制笔记。
• 使用方向键切换笔记和颜色，回车编辑备注，退格键删除。
• 将备注以手写风格显示在正文页边，并用虚线连接对应高亮。
• “全部网页”总览按网页归档笔记，支持搜索、打开原网页和汇总导出。
• 支持导出普通 Markdown，也支持将标注嵌入正文后一起导出。
• 浅色、深色网页均可读，右侧面板使用自适应毛玻璃界面。
• 数据和个性化设置均保存在 Tampermonkey 本地存储中。

安装与升级

首次安装

1. 在浏览器中安装 Tampermonkey。
2. 点击上方“安装 MarkWeb”，Tampermonkey 会自动打开安装页面。
3. 确认脚本信息后选择“安装”。
4. 刷新需要做笔记的网页。

如果浏览器没有自动唤起 Tampermonkey，也可以打开仓库中的 markweb.user.js，复制完整代码，再从 Tampermonkey 管理面板选择“添加新脚本”并粘贴保存。

脚本默认匹配绝大多数 http 和 https 页面，当前排除了 Google 域名以及 0.0.0.0:8999 本地页面。

升级

打开 Tampermonkey 中已经安装的 MarkWeb，使用新版 markweb.user.js 的完整代码覆盖后保存，再刷新网页即可。

请尽量不要删除旧脚本后重新创建。Tampermonkey 可能会把重新创建的脚本视为另一个存储空间，导致原笔记无法直接读取。升级前建议先导出重要笔记。

快速上手

1. 在网页中选中一段文字。
2. 在选区结束位置右上方弹出的六色工具条中选择颜色。
3. 按 ⌘M（macOS）或 Alt+M 打开右侧笔记面板。
4. 点击笔记卡片定位原文；按 Enter 添加或修改备注。

右侧卡片没有冗余操作按钮：单击负责定位和选中，双击会复制笔记。有备注时复制“高亮原文 + 备注”，无备注时只复制高亮原文。

删除单条笔记或清空本页后，页面底部会提供 5 秒撤销入口。

快捷键

方向键、回车和退格键仅在右侧面板打开、处于当前网页模式且已经选中卡片时生效。输入框获得焦点时不会拦截网页按键；点击网页空白处可以退出卡片快捷键状态。

快捷键	功能
↑ / ↓	循环切换笔记并定位原文
← / →	在六个颜色槽之间循环切换
Enter	打开备注编辑框并开始编辑
Esc	收起备注编辑框
Backspace	删除当前笔记，并提供 5 秒撤销
⌘M / Alt+M	打开或关闭当前网页笔记面板
Alt+Shift+M	打开全部网页笔记总览

浏览器如果拦截了 ⌘M，请改用 Alt+M。也可以从 Tampermonkey 菜单选择“打开当前网页笔记”或“打开全部网页笔记”。

右侧面板

面板顶部保持极简布局：左侧为“全部网页”，中间显示当前笔记数量，右侧为设置菜单。设置、页边备注开关、两种导出、清空本页和搜索都收纳在设置菜单中。

• 点击卡片：定位原文并同步选中状态。
• 双击卡片：复制高亮原文和备注。
• 搜索：匹配当前网页的高亮原文或备注；关闭搜索框时自动清除筛选。
• 全部网页：只显示单行网页标题和笔记数量，不展示网址和笔记正文。

面板使用半透明毛玻璃背景，并会根据网页的浅色或深色模式调整颜色。浏览器不支持背景模糊时，会自动回退到更不透明的背景。

设置

点击面板右上角齿轮，再选择“设置”，可以调整：

• 六个高亮颜色槽；修改颜色后，使用对应槽位的已有笔记会同步换色。
• 页边备注开关。
• 备注字体，包括行楷、楷体、宋体、黑体、系统字体、手写体和本机自定义字体。
• 备注字号。
• 备注与正文之间的水平距离。
• 备注位置：自动、正文左侧或正文右侧。

高亮颜色和页边备注设置都可以独立恢复默认值。设置页底部还会展示快捷键说明，但暂不支持自定义快捷键。

默认六色为：

颜色槽	色值
浅粉	#FFDDEA
浅蓝	#C3FAFF
浅黄	#FFFFDD
浅紫粉	#FFE2FF
浅薄荷绿	#C7FFF0
柔黄	#FDF89B

网页高亮使用柔和浅色，卡片色条和页边备注会自动生成一一对应的高饱和颜色。高亮文字会根据背景亮度自动使用深色或白色，以适应网页夜间模式。

页边备注

带有备注的高亮可以在正文左侧或右侧显示纯文本备注，并通过同色虚线连接原文。

• 备注没有背景、边框或阴影，默认使用“行楷-简”。
• 多条备注会自动上下避让；右侧面板打开时会预留面板空间。
• 点击页边备注会打开面板并选中对应卡片。
• 编辑备注后，页边文字会立即更新。
• 视口宽度小于 960px 或正文两侧空间不足时会自动隐藏，避免遮挡正文。
• 自定义字体只会调用本机已安装字体，不会连接第三方字体服务。

导出

导出方式	内容	适用场景
导出笔记	网页信息、高亮原文和备注	快速整理批注
导出含正文	上述笔记 + 提取后的网页正文	保存带上下文的阅读记录
全部网页导出	所有网页的高亮原文和备注	汇总备份全部笔记

“导出含正文”会尽量保留标题、段落、列表、引用、链接和代码块，并过滤导航栏、侧边栏、评论区、推荐、广告、分享工具和页脚等无关内容。正文中的标注会输出为带原颜色和边框样式的 HTML <mark>；文件前部的批注可以点击“跳转到正文标注”进入对应位置。

完整高亮样式需要 Markdown 阅读器允许内联 HTML。即使阅读器不支持内联样式，标注文字仍会保留。正文只在点击导出时读取，不会永久写入 Tampermonkey 存储。

正文识别属于启发式提取：ChatGPT 和常见文章页面通常效果较好，结构特殊的网站仍可能混入少量非正文内容，或遗漏部分正文。

数据与隐私

• 笔记通过 Tampermonkey 的 GM_* 存储接口保存在当前浏览器本地，不需要账号，也不会由 MarkWeb 自动上传到网络。
• 笔记按规范化后的网页 URL 分开保存；URL 的 #锚点 会被忽略，查询参数会保留。
• 刷新网页、关闭浏览器或重启电脑后，已保存笔记和设置仍然存在。
• 删除某个网址的最后一条笔记后，对应网页记录会被清理，不会持续累积空数据。
• 当前标签页中的临时状态会在刷新或关闭标签页后释放。
• 删除 MarkWeb、Tampermonkey、浏览器用户配置或扩展存储，都可能导致数据丢失。

重要笔记请定期导出备份。暂不建议同时在多个标签页编辑同一个网址的笔记，因为后保存的标签页状态可能覆盖先前状态。

兼容性与限制

• 推荐在最新版 Chrome 或 Edge + Tampermonkey 中使用；其他浏览器和用户脚本管理器尚未完整验证。
• 网页正文大幅改版、文本被动态替换或跨多个复杂 DOM 节点时，旧高亮可能无法恢复，但原文字和备注仍会保留在面板中。
• ChatGPT 等动态渲染页面会在内容加载或重新渲染后自动重试恢复标注。
• 标注后立即关闭标签页或立即发生站内路由跳转时，极少数尚在等待写入的变更可能来不及保存；重要操作后建议稍等片刻。
• 含正文导出的结果取决于网页结构，建议导出后简单检查 Markdown 内容。

项目结构

MarkWeb/
├── LICENSE           # MIT 开源许可证
├── markweb.user.js   # 可直接安装的用户脚本
└── README.md         # 项目说明

MarkWeb 是单文件原生 JavaScript 项目，无需安装依赖或执行构建。修改后可以使用下面的命令进行基础语法检查：

node --check markweb.user.js

开源许可

MarkWeb 使用 MIT License 发布。