Markdown Viewer

在浏览器中直接打开本地的 .md / .markdown 文件,以渲染后的效果阅读。不会上传。

打开文件

选择一个 .md 或 .markdown 文件。文件在你的设备上读取。

在浏览器中阅读 Markdown 文件

.md 文件是用 Markdown 语法书写的纯文本——可能是一份 README、一条笔记,或从其他工具导出的文档。这个工具会打开它,并按照 Markdown 编辑器或 Git 托管平台通常呈现的样式,显示标题、列表、链接、表格和代码块。文件在你的设备上读取,不会发送到任何地方。

解析使用 markdown-it,并配置为不将源文件中的原始 HTML 直接传递到页面。渲染出的 HTML 随后会用 DOMPurify 再独立无害化一次——两道相互独立的防线,防止文件被用来在你的浏览器里运行脚本。

支持 GFM 表格和围栏代码块。这是一个单文件查看器:一次只显示一份文档,没有标签页、Front Matter 面板、目录或主题切换。

为什么你的文件不会离开设备

这里的隐私来自结构,而不是承诺。没有"上传"这一步,是因为根本没有可供上传的服务器:

  • 文件的读取、解析和渲染全部在你的浏览器内完成。
  • 渲染出的 HTML 在显示前会被无害化处理,且这一步与它最初是如何生成的无关。
  • 页面以静态文件的形式分发,不会发出携带你数据的请求。
  • 源代码公开,任何人都可以查看(MIT)。
  • 可以离线使用——既然不依赖服务器,离线自然也能用。

想自己确认的话,打开文件时打开浏览器的网络(Network)面板——没有任何请求携带文件内容。 查看源代码。

使用方法

  1. 打开文件

    点击选择一个 .md 或 .markdown 文件,或把它拖到页面任意位置。文件在本地读取。

  2. 阅读渲染后的内容

    标题、列表、链接、表格和代码块会立即显示,且已经过格式化和无害化处理。

  3. 打开其他文件

    点击"打开其他文件"可以关闭当前文档,重新选择一个文件。

常见问题

我的文件会被上传到某个地方吗?

不会。文件的读取、解析和渲染全部在你的浏览器内完成。没有服务器端处理,所以文件内容没有离开设备的途径。源代码公开,你可以在浏览器的网络(Network)面板里确认这一点。

打开别人给的 Markdown 文件安全吗?

解析器配置为禁用原始 HTML,所以源文件中写的任何 HTML 都会以文本形式显示,而不会作为标记被执行。渲染出的 HTML 之后还会用 DOMPurify 再独立无害化一次。链接只允许 http、https、mailto 这三种协议,其他协议会被拒绝。

支持表格和代码块吗?

支持。GitHub 风格的 Markdown 表格和用围栏(```)标记的代码块无需额外设置即可正确渲染。

会显示 Front Matter 或目录吗?

目前这个版本不会。这是一个专注于单文档阅读的查看器——没有 Front Matter 面板、目录、多文件标签页或主题切换。

可以编辑文件吗?

不可以。这是一个只读的本地 Markdown 文件查看器,不会编辑文件,也不会把修改写回文件。

能处理中文或非 UTF-8 编码的文件吗?

可以。文件会先尝试按 UTF-8 解码,失败后再按 Shift_JIS 解码——这是 Markdown 文件常见的两种编码方式。没有手动选择编码的操作。

可以离线使用吗?

可以。它是 PWA,第一次访问后会被缓存,没有网络也能打开。你也可以把它添加到主屏幕,像应用一样使用。