MD Light / MD 轻阅

A tiny, read-only Markdown viewer for Windows. Native RichEdit rendering, no editor, no Electron, no WebView.

一个面向 Windows 10/11 的轻量、只读 Markdown 浏览器：双击即读，不承担编辑职责。

为什么快

MD 轻阅使用 Windows 原生 RichEdit 控件，Markdig 只负责解析 Markdown。启动时不加载 Chromium、Node.js、WebView2 或 JavaScript，也没有编辑器状态、插件系统和后台常驻进程。

在开发机上的参考数据：窗口约 0.3–0.4 秒出现，完整首屏通常低于 1 秒，工作集约 53–59 MB。实际结果会随硬件、杀毒软件和文档复杂度变化。

功能

• 纯只读渲染，不保存或改写源文件
• 标题、段落、粗体、斜体、链接、列表、任务清单、引用、表格、代码块和分隔线
• YAML front matter 与本地图片
• 标题目录、缩放、明暗主题
• 原生滚轮短动画，按系统滚动行数执行且不修改全局设置
• 拖放文件、命令行路径参数
• 源文件被其他程序修改后自动刷新
• UTF-8、UTF-16、GB18030/GBK
• 本地 Markdown 链接在当前窗口打开，外部链接交给系统浏览器
• 不加载远程图片，不执行 HTML 或 JavaScript，无遥测

下载和使用

从 Releases 下载 Windows x64 压缩包，解压后保留目录内全部文件，运行 MdLight.exe。

需要 .NET 8 Desktop Runtime。

& '.\MdLight.exe' 'D:\path\document.md'

快捷键：

• Ctrl+O：打开文件
• Ctrl+J：显示或隐藏目录
• Ctrl++ / Ctrl+- / Ctrl+0：缩放
• F5：刷新

如需加入 Windows“打开方式”，解压后在程序目录运行 Register-OpenWith.ps1。该脚本仅写入当前用户注册表，不强行替换默认应用；Unregister-OpenWith.ps1 可撤销。

从源码构建

环境：Windows 10/11、.NET 8 SDK。

dotnet restore .\src\MdLight\MdLight.csproj
dotnet publish .\src\MdLight\MdLight.csproj -c Release -o .\dist

设计边界

为了保持原生、快速和安全，当前版本不渲染 Mermaid、KaTeX 或可执行 HTML，不主动下载远程图片。20 MB 以上文档会提示，而不是强行加载。

License

MD Light is licensed under the MIT License. Markdown parsing is provided by Markdig, licensed under BSD-2-Clause; see THIRD-PARTY-NOTICES.md.