还在被 Markdown 乱码折磨？5 分钟上手 Markdown Viewer，让浏览器秒变专业阅读器

【免费下载链接】markdown-viewerMarkdown Viewer / Browser Extension项目地址: https://gitcode.com/gh_mirrors/ma/markdown-viewer

晚上十点，我点开同事发来的.md技术方案，浏览器里蹦出的却是满屏#和*的纯文本，标题、列表、代码块全挤在一起，看得头皮发麻。正是这种时刻，我遇见了 Markdown Viewer——一个把 Markdown 文件渲染成精美阅读页面的开源浏览器扩展。它免费、开源，装上之后，你与"能在浏览器里舒服地读 Markdown"之间，只差五分钟。

一句话认识它：给浏览器添一间随身书房

Markdown Viewer 是个浏览器扩展。装好之后，你在浏览器里打开任何.md、.markdown文件，它都会自动接管渲染：标题有层级，代码有高亮，表格对齐，公式能显示，长文档还能带目录。它解决的痛点很直接——让 Markdown 文档在浏览器里"能看"，而且"好看"。

它适合谁？经常读技术文档的开发者、写学习笔记的学生、整理教程的创作者，以及一切受够了纯文本乱码的人。说白了，它像是给浏览器添了一间随身书房，走到哪，文档就在哪被好好"装订"起来。

第一次上手：照着做，五分钟就成功

说实话，第一次装扩展我也怕折腾，实际走下来比想象中简单，一共三步，别急，一步步来。

先把项目拿到本地：

git clone https://gitcode.com/gh_mirrors/ma/markdown-viewer

然后打开 Chrome（Edge、Opera、Brave 同理）的chrome://extensions，把右上角"开发者模式"打开，点"加载已解压的扩展程序"，选中刚才克隆下来的 markdown-viewer 文件夹。这里有个细节：项目里准备了两个清单文件，Chrome 系浏览器选manifest.chrome.json。

Firefox 用户走另一条路：地址栏输入about:debugging#/runtime/this-firefox，点"临时载入附加组件"，选择manifest.firefox.json就行。

装好之后还差关键一步：在扩展管理页找到 Markdown Viewer，点"详细信息"，打开"允许访问文件 URL"开关。这一步不做，本地文件它碰不到，很多人就卡在这里。

搞定后，随便拖一个.md文件进浏览器试试。看到标题、列表、代码块整整齐齐排好版的那一刻，你会觉得这五分钟花得值 🎉。

三个普通用户的故事：Markdown Viewer 这样帮到他们

光列功能没意思，聊聊我身边三个人的真实用法。

阿凯，后端开发。他每周要读大量技术方案和 API 文档，以前浏览器打开.md就是一堆源码，眼睛疼不说，找重点全靠猜。现在他把文档拖进浏览器，标题层级、目录跳转、代码高亮一目了然。他的原话是："以前是看文档，现在是逛文档。"

小鹿，研究生。她的笔记里全是数学公式，以前要么切编辑器，要么截图存着。Markdown Viewer 内置 MathJax 渲染，$E = mc^2$这种行内公式、整段的块级公式，都能在浏览器里直接变成标准排版。她说，上课记的笔记终于也能"原样"打开了。

老周，技术写作者。他写教程离不开流程图、时序图，过去先在别的工具画好再贴图，改一处要重来。现在他直接在文档里写 Mermaid 代码块，浏览器里即时出图，改动顺手就改完了。

三个人用的功能各不相同，但解决的其实是同一件事：让 Markdown 文档真正"可读"。

进阶玩法：Markdown Viewer 这样配置最省心

用熟了之后，有几个设置值得动手调一调。

换解析器，挑顺手的。Markdown Viewer 内置了 markdown-it、marked、remark、commonmark、showdown、remarkable 六种解析器。默认的 markdown-it 完全支持 CommonMark，大多数场景直接用就行；处理老式格式的文档可以试试 showdown；追求轻快就选 marked。相关实现都在项目的background/compilers/目录下，有兴趣可以翻翻源码。

自定义主题，给书房换装潢。设置页里有 30 多套主题：晚上读文档用暗色系，看 README 用 GitHub 风格；还不满足的话，支持上传自己的 CSS 文件作为自定义主题，相当于给这间随身书房量身定做装修。页面宽度也有七档可选，从auto自动适配，到full、wide、large、medium、small、tiny的固定宽度，34 寸大屏和手机竖屏都能找到合适的一档。

把书房搬上网。除了本地文件，GitHub、GitLab 上的.md页面同样能渲染。在高级选项里添加站点授权，支持*.githubusercontent.com这种通配符写法，一次授权管住整个域名。

过来人避坑：常见问题这样解

以我的踩坑经验，新手最容易卡在这三件事上 💡。

问：装好了，双击本地.md还是纯文本？答：九成是没开"允许访问文件 URL"。去扩展详情页打开开关，然后重启一下浏览器，基本就正常了。

问：公式显示成一堆代码？答：先确认设置里 MathJax 已开启，再检查公式括号是否配对。还有个小坑：开启之后，正文里普通的美元符号要写成\$，否则会被误认成公式分隔符。

问：换了主题没反应？答：刷新当前页面；还不行就清一下浏览器缓存，再把扩展重新加载一遍，通常都能解决。

今晚就动手：打开你的 Markdown 随身书房

那间"随身书房"其实已经在你手边，只差你亲手把它打开。找一个以前看着头疼的.md文件，克隆项目、装进浏览器、打开文件访问权限，五分钟，然后看着它被渲染得漂漂亮亮的样子。试过才知道，原来技术文档可以这么顺眼。

git clone https://gitcode.com/gh_mirrors/ma/markdown-viewer

【免费下载链接】markdown-viewerMarkdown Viewer / Browser Extension项目地址: https://gitcode.com/gh_mirrors/ma/markdown-viewer