AI摘要

SaMDeditor是一款适用于Windows 11的轻量级多格式阅读与Markdown编辑工具，支持Markdown、TXT、PDF和EPUB文件。软件提供多标签页、文档大纲、源码编辑、自动保存与恢复等功能，支持Mermaid图表全屏查看、拖拽平移和缩放，代码段一键复制。EPUB阅读支持字体、字号、颜色、行距、字间距及阅读风格设置。软件内置多种语言界面，文件在本地处理，注重阅读体验、操作效率与数据安全。软件版本为1.7，支持系统为Windows 11 x64。

SaMDeditor 软件介绍

一、软件简介

SaMDeditor 是一款面向 Windows 11 的轻量级多格式阅读与 Markdown 编辑工具，支持 Markdown、TXT、PDF 和 EPUB 文件。软件提供多标签页、文档大纲、源码编辑、自动保存与恢复等功能；Mermaid 图表支持全屏查看、拖拽平移和缩放，代码段可一键复制。EPUB 阅读支持字体、字号、颜色、行距、字间距及阅读风格设置。软件内置简体中文、繁体中文、英语、日语、韩语、西班牙语、德语和法语界面，文件在本地处理，注重阅读体验、操作效率与数据安全。

软件版本：1.8
支持系统：Windows 11 x64
工作方式：本地、离线优先
作者：Samool
官方博客：www.samool.com

二、格式能力一览

格式	阅读	编辑	大纲	保存与导出
Markdown（.md、.markdown）	GFM、代码高亮、Mermaid	Markdown 源码	有标题时自动显示	保留编码、导出 PDF
TXT（.txt）	纯文本	纯文本	默认隐藏	保留编码
PDF（.pdf）	本地只读	不支持	有书签时自动显示	不修改原文件
EPUB（.epub）	纵向连续滚动	不支持	有目录时自动显示	恢复阅读位置，不修改原文件

三、核心功能

1. Markdown 阅读与编辑

打开文档后默认进入阅读模式，底部可随时切换“阅读”和“编辑”。
支持 GFM 常用语法，包括标题、表格、任务列表、引用、链接、删除线和代码块。
代码块提供一键复制按钮，并显示复制结果。
源码编辑器支持 Markdown 高亮、行号、查找替换、撤销重做、自动缩进和常用括号配对；剪切、复制、粘贴、全选右键菜单与正文统一使用 Microsoft YaHei UI。
长段落按照编辑区宽度自动软换行，不会向文件写入额外换行；折行后的行号仍对应原始逻辑行。
Markdown 格式工具栏固定居左、紧凑排列；支持 H1-H3、粗体、斜体、删除线、链接、引用、行内代码、代码块、无序列表、有序列表、任务列表、表格和分隔线。
选中文字后点击工具按钮可直接包裹格式；再次点击粗体、斜体等行内格式可取消标记。
工具栏空间不足时可以横向滚动，TXT 编辑时不会显示 Markdown 工具栏。
支持 UTF-8、UTF-8 BOM 和 ANSI（GBK/CP936）编码，保存时默认保留原编码。

2. Mermaid 图形增强阅读

Mermaid、GFM 和代码高亮资源随软件离线提供，运行时不依赖在线 CDN。
点击全屏按钮或双击图形即可进入 Windows 真正全屏模式。
全屏画布支持鼠标左键按住拖拽平移，以及滚轮焦点缩放。
提供放大、缩小、适应屏幕、1:1 和居中操作。
使用 SVG 矢量渲染，放大后仍保持清晰。
按 Esc 可快速退出全屏。
全屏退出、窗口最小化或隐藏时，WebView2 输入层会与主窗口同步显隐，不会在桌面残留不可见的点击遮挡区域。

亮点功能流程图

下面的图形由 SaMDeditor 内置 Mermaid 引擎离线渲染。双击图形即可进入全屏，然后按住鼠标拖拽、滚轮缩放，直接体验 SaMDeditor 的图形阅读方式。

flowchart LR
    A[打开 Markdown] --> B[本地 GFM 预览]
    B --> C{存在文档标题?}
    C -- 是 --> D[自动显示大纲]
    C -- 否 --> E[正文占满可用空间]
    B --> F{包含 Mermaid?}
    F -- 是 --> G[离线渲染 SVG]
    G --> H[双击进入系统全屏]
    H --> I[按住鼠标拖拽平移]
    I --> J[滚轮焦点缩放]
    J --> K[适应屏幕 / 1:1 / 居中]
    B --> L[导出 A4 PDF]

    classDef normal fill:#f4f7f5,stroke:#9eb4aa,color:#33423b
    classDef accent fill:#dff3e8,stroke:#65a984,color:#244235
    class A,B,C,D,E,F,L normal
    class G,H,I,J,K accent

Mermaid 全屏交互时序图

预览与 Mermaid 渲染均在本机完成，不上传文档正文。进入全屏后，鼠标操作会直接转换为 SVG 画布的平移和缩放。

sequenceDiagram
    actor U as 使用者
    participant A as SaMDeditor
    participant W as 本地 WebView2
    participant M as Mermaid 引擎
    participant S as Windows 窗口

    U->>A: 打开 .md 文件
    A->>W: 传入 Markdown 内容
    W->>M: 离线渲染 Mermaid
    M-->>W: 返回矢量 SVG
    W-->>U: 显示预览和文档大纲
    U->>W: 双击 Mermaid 图形
    W->>A: 请求进入全屏
    A->>S: 切换系统全屏窗口
    loop 查看复杂图形
        U->>W: 按住拖拽 / 滚轮缩放
        W-->>U: 实时平移 / 焦点缩放
    end
    U->>W: 按 Esc
    W->>A: 请求退出全屏
    A->>S: 恢复编辑器界面

3. 智能文档大纲

Markdown 存在 H1-H6 标题时，自动显示当前文档大纲。
PDF 存在内嵌书签时，自动显示书签大纲。
TXT、无标题的 Markdown 和无书签的 PDF 不显示大纲栏，不占用正文空间。
大纲层级默认全部展开；一级标题可折叠其二级及更深目录，二级标题也可继续折叠三级及更深目录，切换文档标签后保留本次运行期内的操作状态。
点击大纲节点会瞬时定位到目标章节或 PDF 页面，不播放耗时的长距离滚动动画。
大纲栏支持调整宽度和字体大小，也可以手动隐藏。

4. 多标签页与文件操作

同一窗口可同时打开多个 Markdown、TXT 和 PDF 文档。
顶部文件标签栏采用 36px 紧凑高度，减少对正文空间的占用。
标签右键菜单支持关闭当前、关闭其它、关闭左侧所有和关闭右侧所有。
支持文件选择器、Windows 文件关联、命令行参数和拖拽文件到窗口。
软件采用单实例模式，再次打开文件会自动转发到已有窗口。
默认恢复上次打开的标签页和活动文档。

5. TXT 查看与编辑

TXT 使用纯文本语义，不把 #、代码围栏等字符解释为 Markdown。
支持纯文本预览、源码编辑、软换行、编码识别、保存、自动保存和异常恢复稿。
TXT 默认不显示大纲栏，也不显示 Markdown 格式工具栏。

6. PDF 阅读

PDF 使用随软件分发的 PDF.js 离线只读查看，不上传文件。
支持上一页、下一页、页码跳转、缩放和适合宽度。
支持读取 PDF 内嵌书签并生成左侧大纲。
PDF 只提供阅读能力，不会修改原文件。

7. Markdown 导出 PDF

可将当前 Markdown 预览一键导出为 A4 PDF。
保留中文、GFM 表格、代码高亮、Mermaid 图形和标题书签。
自动移除预览工具按钮，并避免生成无效尾部空白页。

8. 保存、恢复与文件安全

默认使用手动保存，未保存文档会在标签和窗口标题中显示标记。
可在设置中启用自动保存并选择保存间隔。
软件定期保存会话检查点，异常退出后可恢复最近的临时稿。
检测到文件被外部程序修改时，会询问是否重新加载。
关闭程序时先隐藏窗口再写入会话，减少可见等待和退出卡顿。

四、界面、语言与性能

1. 紧凑桌面界面

启动窗口占主屏幕宽度的 50%、高度的 80%，自动居中，左右各保留 25%、上下各保留 10% 空间；需要更大阅读区域时仍可最大化或进入 Mermaid 全屏。
文件菜单、文档标题、主题切换和窗口控制按钮共用一行标题栏。
顶部菜单与弹出列表紧密衔接，菜单项采用适合鼠标操作的紧凑高度。
设置窗口按“外观与字体、渲染与性能、文件与会话”三个标签分类，最大约 620×400px，并适配低分辨率和高显示缩放环境。
软件全部可控文字统一固定使用 Microsoft YaHei UI，包括菜单、标题栏、文件标签、设置、大纲、Markdown 正文与代码块、源码编辑及其右键选择菜单、TXT 预览、Mermaid 图形文字和 PDF 阅读器工具栏；PDF 页面自身仍按原文件嵌入字体忠实呈现，避免破坏版式。
支持浅色、深色和跟随 Windows 三种主题模式，标题栏右侧可快速切换日间/夜间效果。

2. 七种界面语言

SaMDeditor 支持以下界面语言：

简体中文
繁體中文
English
日本語
한국어
Español
Deutsch
Français

安装器提供八种语言选择，并将安装语言写入软件配置；首次启动默认使用该语言，也可以在“设置 → 外观与字体 → 语言”中切换。未通过安装器写入语言时跟随 Windows，系统语言不在支持范围则回退到 English。多语言覆盖原生菜单、设置、文件与保存提示、恢复状态、Markdown 代码复制、Mermaid 全屏画布和 PDF 阅读器。

3. 启动与渲染体验

Markdown 正文初始化期间显示跟随主题的加载提示和动画，避免 WebView2 尚未完成首屏绘制时出现黑色正文区域。
大纲跨章节导航采用瞬时定位，长文档滚动过程减少重复布局。
WebView2 默认进行 GPU 合成能力检测，只在检测结果明确可用时启用硬件加速。
遇到 GPU 被禁用、软件适配器、驱动回退或检测异常时，自动使用兼容性更高的软件渲染。
用户可在“设置 → 渲染与性能”关闭自动硬件加速；修改后重启生效。
WebView2 原生输入窗口受主窗口生命周期统一管理；最小化或隐藏 SaMDeditor 后，桌面图标与其它应用仍可正常点击。

五、Windows 集成与兼容性

安装程序根据 Windows 界面语言预选，并允许用户在 8 种安装语言中手动切换。
“创建桌面快捷方式”和“注册 SaMDeditor 为 Markdown (.md) 打开程序”默认勾选。
应用图标与浅色 Markdown 文件关联图标分别设计，便于在资源管理器中识别。
Release 随包携带 Flutter 所需的 Microsoft VC++ 应用本地运行库，干净系统无需另行安装 Visual C++ Redistributable。
安装器先在程序目录创建 log.txt，Windows Runner 从进入程序入口开始继续记录启动阶段。
安装目录不可写时，日志自动回退到 %LOCALAPPDATA%\SaMDeditor\Logs\log.txt，再次失败时回退到 %TEMP%\SaMDeditor\log.txt。
日志超过 2MB 时轮换为 log.txt.previous，不会记录 Markdown、TXT 或 PDF 的正文。

六、安装与基本使用

安装

运行安装包 SaMDeditor-1.6-windows-x64-setup.exe。
选择安装界面及软件首次使用的语言。
查看对应语言的软件介绍并选择安装目录。
按需保留默认勾选的桌面快捷方式和 Markdown 文件关联。
安装完成后，可双击 .md 文件或在 Windows“打开方式”中选择 SaMDeditor。
如果 Windows 已保存其它受保护的默认应用，请进入“设置 → 应用 → 默认应用”，手动将 .md 设置为 SaMDeditor。

八种语言的《软件介绍》都会随程序一同安装。1.6 版本首次成功启动时会按当前软件语言自动打开对应版本一次，后续启动不重复打扰；从旧版本升级的用户也能查看本版最新介绍。

打开与编辑文档

点击“文件 → 打开”，或把 .md、.markdown、.txt、.pdf 文件拖入窗口。
Markdown 和 TXT 可通过底部按钮切换预览与源码编辑。
使用 Ctrl+S 保存，使用 Ctrl+Shift+S 另存为。

查看 Mermaid 图形

在 Markdown 预览中找到 Mermaid 图形。
点击全屏按钮或双击图形进入全屏。
按住鼠标左键拖动图形，滚动鼠标滚轮缩放。
按 Esc 退出全屏。

导出 PDF

打开 Markdown 文档并进入预览模式。
选择“文件 → 导出 PDF”。
选择保存位置后等待导出完成。

七、隐私与安全

Markdown、TXT、PDF、会话和恢复稿仅在本机处理，不上传文档内容。
Markdown、Mermaid 和 PDF 渲染资源随安装包离线分发，运行时不依赖 CDN。
HTML 预览经过白名单清洗，限制脚本、iframe、表单和活动媒体。
Mermaid 使用严格安全模式。
PDF 通过仅绑定 127.0.0.1、带随机令牌的只读资源通道传入阅读器，局域网无法访问。
WebView 弹窗和权限请求默认拒绝，外部链接交给系统默认程序处理。

八、更新日志

V1.7 内容包括：

Markdown 源码工具栏升级
源码与预览实时双栏
固定品牌标题
全局版本配置
8 种语言介绍更新
升级兼容性说明
自动化测试结果

V1.7 更新内容：

EPUB 阅读与个性化设置
本机字体及真实字形
阅读风格、进度与统计
文件图标及关联管理
EPUB 兼容性修复
混合 DPI 多屏窗口修复
本地安全与离线能力
V1.6 功能延续
安装升级及发布验证

V1.6 更新内容：

修复 CP936/GBK 编码的 Markdown、TXT 文件无法打开或保存的问题。
ANSI 读取、保存和回读校验统一使用 Windows 代码页 936。
“关于”窗口显示完整版本号和安装包构建时间。
应用、Windows EXE、安装器及首次启动标记统一升级到 V1.6。
8 份多语言软件介绍全部升级并加入 V1.6 更新说明。
支持从 V1.5 直接覆盖升级，保留设置、语言、会话和恢复稿。

V1.5 更新内容：
1.5 在保留 1.3 全部 Markdown、Mermaid、TXT、PDF 与恢复能力的基础上，重点完成以下升级：

新增七种界面语言，支持跟随 Windows 自动选择或在设置中固定语言。
新增 Markdown 常用格式工具栏，按钮居左紧凑排列，帮助新用户快速完成排版。
源码编辑器新增真实软换行和折行行号对齐，长段落不再需要横向滚动。
文件标签栏进一步收紧为 36px，提高正文可用高度。
Markdown 首屏加入主题化加载提示和动画，避免启动阶段出现黑色正文区域。
多语言覆盖 Markdown、Mermaid 和 PDF 内嵌页面，避免界面语言不一致。

完整变更请查看程序源码根目录中的《更新日志.md》。

九、当前版本边界

暂不支持数学公式渲染。
暂不提供图片编辑能力。
PDF 仅支持查看，不支持修改、批注或表单编辑。
ANSI 当前按 GBK/CP936 处理。
PDF 只有在文件自身包含书签时才显示大纲栏。
第一版发布目标仍为 Windows 11 x64。

十、系统要求与发布信息

操作系统：Windows 11 x64
必需组件：Microsoft Edge WebView2 Runtime（Windows 11 通常已预装）
软件名称：SaMDeditor
安装包：SaMDeditor-1.5-windows-x64-setup.exe
安装包 SHA-256：以发布目录中与安装包同名的 .sha256.txt 文件为准
作者：Samool
博客：www.samool.com

十一、下载地址

通过网盘分享的文件：SaMDeditor-1.8-windows-x64-setup.exe
下载地址：https://pan.baidu.com/s/1lvSslkdj7egYMwoZa4x85A?pwd=jbbh 提取码: jbbh
SHA-256：D22DE238A0FDE67BEF715CA7DE3AC4A64989B333E923CF2AE82F8CDFA5EB669B

通过网盘分享的文件：SaMDeditor-1.7-windows-x64-setup.exe
链接: https://pan.baidu.com/s/1zIL5leD2lXTCe-jshVnTAA?pwd=p97c 提取码: p97c
SHA-256：F318454E2EACF1F6F50A71867964444C54074C94F4164EFE79D53E9653BB8F0A

通过网盘分享的文件：SaMDeditor-1.6-windows-x64-setup.exe
链接: https://pan.baidu.com/s/1crFBu3ykLLuR7pqESVZF7g?pwd=tby3 提取码: tby3
版本：1.6.0
大小：14,978,706 字节
构建时间：2026-08-27 17:39:43
SHA-256：A52377B658F0B6A505E6376222103D61A15D5881626B63A51173FAC824BA3437

通过网盘分享的文件：SaMDeditor-1.5-windows-x64-setup.exe
链接: https://pan.baidu.com/s/1e4Rc0JbIhqBtNYzOmnK46w?pwd=ctyu 提取码: ctyu
SHA-256：E9EAC9818E75896C75B8ABE6B62AA54CE61EF78FF92285E6E14731DB2E735911

SaMDeditor 正式发布