企业官网建设流程全解析

3 分钟把浏览器升级成 Markdown 阅读器：Markdown Viewer 免费扩展完整指南

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

上周同事给我发来一份.md格式的项目说明，我习惯性地双击打开，屏幕上瞬间铺满带#号和一排排竖线的"裸源码"——标题、列表、代码块全挤成一团。那一刻我特别想摔键盘：这份文档明明写得那么用心，为什么浏览器就是不肯好好排版？

别担心，今天要聊的这个开源扩展Markdown Viewer，专治这种"浏览器打开 Markdown 文件只能看到纯文本"的尴尬。它能把浏览器变成专业的Markdown 阅读器，完全免费、开源、无需注册，看完这篇文章，你大概花 3 分钟就能用上。

一句话说清楚：它到底是干什么的

如果你只需要一个结论：Markdown Viewer 是一个浏览器扩展，装上之后，你在浏览器里打开的任何.md文件——无论是本地下载的、还是托管在网站上的——都会被自动渲染成排版精美、可换主题的阅读页面，而不是一团乱麻的代码。

它不只是一层"渲染壳"，更像一个完整的阅读环境：30+ 主题、暗黑模式、自动重载、目录生成、公式、图表、代码高亮，专业写作工具该有的功能，几乎都被塞进了浏览器里。

小白也能完成的安装步骤：从拿到代码到看到第一个效果

第一步：把项目代码拿下来。打开终端，执行：

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

第二步：装进 Chrome / Edge 系浏览器。地址栏输入chrome://extensions，打开右上角的"开发者模式"，点击"加载已解压的扩展程序"。这里有个容易卡住的小细节：仓库里同时放着manifest.chrome.json和manifest.firefox.json两份清单，而 Chrome 只认manifest.json，所以先把manifest.chrome.json改名为manifest.json，再选择整个文件夹，就能顺利加载。

第三步：Firefox 用户走这边。打开about:debugging#/runtime/this-firefox，点击"临时载入附加组件"，直接选择manifest.firefox.json文件即可——Firefox 是支持直接选清单文件的。

第四步：见证第一次效果。回到chrome://extensions，找到 Markdown Viewer，点"详细信息"，打开"允许访问文件 URL"开关，然后双击任意一个.md文件。恭喜，你的浏览器已经具备专业的 Markdown 渲染能力了 🎉。

安装过程中的疑问都可以在官方文档 README.md 里找到答案，Firefox 用户还有一份专属的 firefox.md 排坑指南。

三类人最容易爱上的玩法

学生党：把讲义和笔记读成"书"

写论文、看老师发的.md讲义时，最痛苦的就是公式显示。在设置里打开 MathJax 开关，$E = mc^2$这种行内公式、整段 LaTeX 公式都能完美渲染；再打开目录（ToC）和暗黑主题，深夜复习时眼睛也能少受点罪。记不清看到哪了？它还会自动记住滚动位置，下次打开接着看 📖。

开发者：README 和文档体验直接拉满

程序员日常无非是读 README、翻 API 文档、看技术规范。Markdown Viewer 内置了 6 种解析器（markdown-it、marked、remark 等），解析器源码都在 background/compilers/ 目录下，默认的 markdown-it 完全支持 CommonMark 和 GFM 表格；代码块交给 Prism 做语法高亮，流程图、时序图用 Mermaid 直接画，还能按住 Shift 滚轮缩放图表。写文档的时候打开自动重载，文件一保存页面就刷新，边写边看，效率直接翻倍。

普通用户：双击即读，零学习成本

最爽的一点是，你不用记任何快捷键。把扩展装好、权限开好之后，本地.md文件就像网页一样双击打开，emoji 短代码（比如:smile:）会自动变成小图标，7 种内容宽度（从tiny到full）随便调，大屏小屏都能舒舒服服地读。

过来人替你踩过的几个坑

1. 装了却打不开本地文件：九成是忘了开"允许访问文件 URL"这个开关，去扩展详情页把它打开，然后重启浏览器。
2. Chrome 加载文件夹报错：检查一下manifest.chrome.json有没有改名为manifest.json，这是最常见的报错原因。
3. 开了公式渲染后，普通美元符号全乱了：比如价格"$9.9"会被当成公式，解决办法是把美元符号转义成\$。开启 MathJax 后这属于正常行为，习惯就好。
4. 切换主题没反应：先刷新当前页面，再不行就清一下浏览器缓存，最后重新加载扩展，三步排查基本都能解决。

别小看它，还能玩出这些花样

如果你愿意多花点时间，这个扩展的可玩性比想象中高。比如在设置里上传自己的 CSS，打造一套专属主题；给*.githubusercontent.com这类域名配好通配符授权，逛代码托管平台时文档直接内嵌渲染；配合 localhost 服务器，把自动重载当成"实时预览"用，写博客草稿比在编辑器里还顺。渲染相关的逻辑都集中在 content/ 目录，读代码也是一种乐趣。

写在最后：现在花 3 分钟，换以后每一份文档的好心情

回想一下，从"看到 .md 就皱眉"到"看到 .md 就想点开读"，差的只是一个 3 分钟的安装动作。Markdown Viewer 解决的不是什么惊天动地的大问题，但它把那些每天都会碰到的小摩擦，一个个抹平了——这正是好工具的意义。

现在就打开浏览器按上面的步骤装一个，然后随便找个 .md 文件试试。如果觉得好用，别忘了把它分享给身边同样被裸代码折磨过的朋友。祝你的每一次阅读，都像翻一本排版考究的书 📚。

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