快速上手

• 这是一个单文件、零依赖的阅读器：把 .md 拖进窗口就能读，也可以点右上角「导入」选多个文件。
• 要读别处的文件：点右上角「导入」选多个 .md，或直接把文件拖进窗口。
• 要显示正文里的图片，请拖「整个文件夹」而不是单个 md：浏览器不允许网页凭文件名猜本地路径。
• 导入的文件保存在本浏览器中（localStorage），刷新页面不会丢失。

图片显示

• Markdown 的 ![说明](图片地址) 按图片渲染；远程 https 图片直接加载。
• 手动导入：请连同图片一起文件夹导入；导入后会尝试自动定位「图片根目录」，之后图片直接读磁盘，刷新页面依然显示，也不会把图片复制进浏览器。
• 图片没显示时，正文顶部会出现一张诊断卡，写清原因并给出一键解决入口，而不是只留一堆虚线占位块。

阅读与导航

• 左侧点击文件名切换阅读；右侧自动生成 H1~H3 章节锚点，滚动时高亮当前章节。
• 顶部「A− / A+」调节正文字号，「主题」切换暗/浅色。

阅读增强

• 点正文里任意图片可全屏查看：滚轮或单击缩放，放大后按住拖动平移，←/→ 翻本篇上一张 / 下一张，Esc 关闭；长截图默认整张装进屏幕。
• 顶栏下方那条细线是阅读进度；正文开头的「字数 · 预计读完时间 · 文件大小」一眼看清篇幅。
• 左侧文件名前的圆点是未读标记：滚到文末自动变灰，也可点圆点手动切换；目录行显示未读篇数。
• 关掉再打开、换一篇再回来，都会接着上次读到的位置继续。
• 顶栏「专注」或按 F 进入专注模式：隐去侧栏与目录、正文限宽居中；再按一次 F 或按 Esc 退出。

复制 · 打印 · 写回磁盘

• 正文顶部的「复制为富文本」把整篇连同格式放进剪贴板，可直接粘进公众号 / 飞书 / Word（本地图片不会被带走，需手动上传）。
• 「打印 / 存 PDF」调起打印窗口，目标选「另存为 PDF」即可导出；打印版式固定浅色，不受当前主题影响。
• 编辑态底部多一个「写回磁盘」：把改动直接存回 md 原文件。首次需在系统对话框里选中原文件——浏览器不允许网页自行覆盖文件，这一步无法绕过；之后本页会记住它。
• 记住之后，编辑态按 Ctrl/Cmd+S 就是「保存 + 直接写回原文件」。按 Shift 点「写回磁盘」可改绑其他文件；不支持的浏览器会自动改为下载。

检索与目录

• 检索结果顶部显示「几篇命中 · 共几处」；Enter 跳下一处、Shift+Enter 跳上一处，走到本篇尽头会自动翻到下一篇命中的文章。
• 输入框空着并聚焦时列出搜索历史，点一下即可重搜。
• 目录行前的小三角可展开该系列下的文章（树形浏览），点目录名仍是切换右侧列表，展开状态会被记住。

任务列表 · 代码 · 外观

• Markdown 任务列表（- [ ] / - [x]）渲染成可勾选方框：阅读态直接点方框就会勾上 / 取消，并写回 md 源码；编辑态里勾选同样会被保存。
• js / json / bash / sh 代码块带语法高亮（零依赖、离线可用）；其他语言保持纯文本。
• 正文顶部「样式」可以注入你自己的 CSS（改行距、标题颜色等），立即生效、只存在本浏览器，「恢复默认」一键撤销。

全文检索

• 左侧搜索框输入即检索全部笔记，点击结果跳转到正文并高亮命中位置。
• 三种写法：空格分隔多个词 = 全部命中（如 技术 方案）；引号包裹 = 精确短语（如 "全文检索"）；首尾斜杠 = 正则（如 /里程碑|风险/）。

编辑与保存

• 点右下角「编辑」进入编辑态：可在「所见即所得」下直接修改正文，或切换到「源码」直接编辑 Markdown。
• 「完成」保存并退出，「取消」放弃未保存改动；「导出」下载 .md 后替换原文件即可落盘。
• 快捷键：Esc 取消编辑 · Ctrl/Cmd+S 保存 · 源码模式 Tab 插入缩进。

目录管理

• 「目录」区默认含「全部笔记 / 未分类」，导入的文件自动归入「未分类」；点「+ 新建」可建新目录。
• 把文件拖到目录上、或 hover 文件点文件夹图标选「移动到」，即可归类；hover 文件点 × 可从列表移除。

数据说明

• 所有内容仅存于当前浏览器：删除文件仅移除列表、不影响电脑上的原文件。
• 更换浏览器或清除缓存会导致笔记丢失，重要内容请用「导出」备份。

这里的 CSS 会盖在阅读器默认外观之上（正文、侧栏、代码块都能改），点「保存并应用」立即生效，只存在本浏览器、不碰 md 文件。
例：.content{ line-height:1.9; } · .markdown-body h2{ color:#4a9eff; }