README

Markdown 原生预览中文版

在 Windows 文件资源管理器右侧预览窗格中阅读 Markdown，支持中文界面和内嵌 WebP／JPEG 图片，无需改写原始 .md 文件。

本项目是二次开发版本，不是从零开发的 Markdown 引擎，也不是原作者的官方发行版。 基于 EtheaDev/MarkdownShellExtensions v2.8.5，原作者为 Carlo Barazzetta / Ethea S.r.l.。感谢原作者及上游贡献者提供的原生预览框架和组件。完整上游提交历史及许可证予以保留。

下载安装包 · 安装与使用 · 开发与构建 · 来源与贡献

图片来自本项目预览控件的测试宿主；正式使用位置是资源管理器右侧预览窗格。示例图片为本项目新建的几何图形。

适合谁

• 经常在资源管理器中浏览 Markdown 笔记、导出文档和产品资料的 Windows 用户。
• 希望选中文件后直接查看排版和图片，而不是另开编辑器的用户。
• 文档包含 data:image/...;base64,... 图片，预览时出现空白或图片被拦截的用户。
• 需要简体中文界面、原生渲染和可读源码的用户。

能做什么

功能	本分支说明
右侧预览	使用 Windows 资源管理器预览窗格，保留 Alt+P 操作习惯
中文界面	工具栏、设置、颜色名称、查找、关于和相关提示文字
内嵌图片	修复 Base64 转义字符；新增原生 WebP 解码，兼容原有 JPEG
Markdown 排版	沿用上游 MarkdownProcessor 与 HTMLViewer
原文件保护	预览过程不重写原始 Markdown、不生成图片旁置文件
安装范围	按当前用户注册预览处理器，不修改双击默认打开程序
恢复	保存安装前关联，并提供恢复脚本

运行时使用 Delphi/VCL、HTMLViewer 和 libwebp，预览 DLL 不依赖 PowerToys、.NET 或 WebView2。资源管理器宿主、Windows COM 和系统 API 仍然属于 Windows 的必要基础设施。安装脚本使用系统 PowerShell；测试工具使用 .NET，这些不是预览 DLL 的渲染依赖。

快速开始

1. 从 Releases 下载 MarkdownPreview-ZhCN-2.8.5-local3-win64.zip，解压到本地目录。
2. 打开解压目录中的 PowerShell，运行：
   powershellCopy

   powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\安装.ps1

3. 关闭并重新打开要浏览的资源管理器窗口，按 Alt+P 打开右侧预览窗格，再选中 .md 文件。
4. 可先用安装包中的 预览演示.md 检查文字、表格与图片。

支持的扩展名：.md、.markdown、.mkd、.mdwn、.mdown、.mdtxt、.mdtext、.mkdn。

当前仅提供 Windows x64 安装包；本机 Windows 环境实测通过，未完成所有 Windows 版本、ARM64 和 32 位系统的兼容性测试。二进制未进行商业代码签名。

你的文件与原有软件会发生什么变化

安装脚本把两个 DLL 放到当前用户的 %LOCALAPPDATA%\Programs\EtheaMarkdownPreview-2.8.5-local3-zhCN，在 HKCU 注册对应扩展名的预览处理器。若已安装 PowerToys，只关闭其 Markdown 预览开关，不卸载其他 PowerToys 功能。不会批量解锁文件、关闭系统安全机制或修改 Markdown 内容。

该插件沿用上游 CLSID，不能和原版 Ethea 预览处理器同时接管相同扩展名。脚本会拒绝覆盖未知的 Ethea 安装。安装与恢复细节见 使用说明。

本分支维护者的贡献

本分支由 panxiaosen（pans 工作室） 主导二次开发与维护：

1. 明确保留资源管理器右侧预览、保持原始文档不变的产品需求，并完成本机使用验证。
2. 完成面向中文用户的界面翻译，包括 DFM 资源、动态提示和通用资源翻译；修复混合文字资源编码问题。
3. 修复 Markdown 处理链中 Base64 图片地址被百分号转义后无法解码的问题。
4. 接入 libwebp，编写原生解码桥接 DLL，并在内存中转换为 HTMLViewer 可显示的图像。
5. 整理当前用户安装、关联备份、恢复脚本、原创演示文件和中文说明。

这些是对上游的增量贡献。Markdown 渲染器、预览框架、编辑器与第三方图形库仍属于原作者及各自贡献者，不能归为本分支原创。更细的来源见 NOTICE.md。

已知边界

• 更新入口仍沿用上游逻辑。不要通过插件内“检查更新”安装上游安装器来升级本分支，否则可能覆盖中文化和图片修复。请以本仓库 Releases 为准；建议在设置中关闭自动检查。
• 远程 HTTP(S) 图片的防盗链、认证、网络阻断等问题不属于本次修复范围；不保证任意外链都可显示。
• 不包含浏览器 JavaScript 引擎，不承诺与 GitHub 网页、Mermaid 或浏览器 CSS 完全一致。
• 共享编辑器界面源码也有翻译，但此发行包只安装预览处理器；独立编辑器和第三方所有异常分支没有完整运行验收。
• 保留标准格式名、字体名、代码标识符、作者姓名、上游英文注释和许可证原文。

验证与许可

Win64 Release 编译通过；测试宿主验证了中文工具栏和内嵌 WebP，真实资源管理器验证了原文及图片；原始测试文档的 SHA256 前后相同。原始私人文档及完整桌面截图没有上传。编译存在上游 SynEdit 的既有字符转换警告。

项目主许可证沿用 Apache-2.0。第三方组件按照各自许可证分发，包括 HTMLViewer、libwebp 及上游附带组件；请查阅 来源与贡献 和各组件目录。