MDViewer

快速上手

2026-07-27 915 字 约 2 分钟

三种打开本地 Markdown 的方式、界面布局说明，以及支持的文件类型。

入门

MDViewer 在两个地方渲染 Markdown：浏览器端阅读器（直接打开你电脑里的文件）和这份使用文档。两者共用同一套渲染引擎与主题，所以这里看到的效果，就是你自己文件的效果。

打开本地文件

回到阅读器首页 ，用下面任意一种方式：

方式 操作 适用场景
打开文件夹 点「打开文件夹」按钮，或按 O 阅读整个文档库，可跨文件搜索与跳转
打开单个文件 点「打开单个文件」，或按 Shift+O 只想看一篇
拖放 把文件夹或 .md 文件拖到页面任意位置 最快

说明

文件不会上传到任何服务器。整个读取与渲染过程都在浏览器内完成，关闭标签页即释放。

浏览器兼容性

打开文件夹依赖 File System Access API ：

  • Chrome / Edge / Opera 86+：完整支持，包括记住上次打开的文件夹
  • Safari / Firefox：自动回退到 <input webkitdirectory> 与拖放，仍可正常阅读，但不能记住上次的目录（需要每次重新选择）

会话恢复

用支持的浏览器打开文件夹后，目录句柄会存进 IndexedDB。下次访问时：

  • 若权限仍然有效，自动恢复到上次阅读的文件与滚动位置
  • 若权限过期，右下角出现「继续阅读」提示，点一下重新授权即可

首页的「最近打开」列表保留最近 8 个工作区。

界面布局

  • 左侧文件树：按目录层级展开，顶部输入框可按文件名筛选，B 收起
  • 中间正文：宽度、字号、行距、字体都能在设置里调，, 打开设置
  • 右侧大纲：从二级到四级标题自动生成，滚动时高亮当前章节，T 收起

支持的文件类型

阅读器扫描目录时会收录：

  • 文档：.md .markdown .mdown .mkd .mdx .txt
  • 图片：.png .jpg .gif .svg .webp .avif .bmp .ico（供 Markdown 中的相对路径引用）

自动跳过 .git、node_modules、dist、build、.obsidian 等目录，以及所有以 . 开头的隐藏文件。单次最多扫描 6000 个文件、12 层深度。

相对路径解析

文档里这样写的图片和链接都能正常工作：

1
2
3
4
5

![架构图](./images/arch.png)
![上级目录的图](../assets/logo.svg)

[跳到另一篇](./advanced/config.md)
[目录索引](../guide/)

图片会从工作区里找到对应文件并生成本地 Blob URL；.md 链接会直接在阅读器内跳转，不刷新页面。找不到的目标会标红并给出提示。

下一步