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文件——无论是本地下载的、还是托管在网站上的——都会被自动渲染成排版精美、可换主题的阅读页面而不是一团乱麻的代码。打开 Markdown 文件的场景以前的样子装完扩展之后本地.md文件满屏#号和裸代码标题、列表、代码块全部排版完成网站上的 README、教程常被当成纯文本下载直接在网页里渲染成阅读视图带公式和图表的文档乱码、显示不出LaTeX 公式、Mermaid 图表照常呈现它不只是一层渲染壳更像一个完整的阅读环境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随便调大屏小屏都能舒舒服服地读。过来人替你踩过的几个坑装了却打不开本地文件九成是忘了开允许访问文件 URL这个开关去扩展详情页把它打开然后重启浏览器。Chrome 加载文件夹报错检查一下manifest.chrome.json有没有改名为manifest.json这是最常见的报错原因。开了公式渲染后普通美元符号全乱了比如价格$9.9会被当成公式解决办法是把美元符号转义成\$。开启 MathJax 后这属于正常行为习惯就好。切换主题没反应先刷新当前页面再不行就清一下浏览器缓存最后重新加载扩展三步排查基本都能解决。别小看它还能玩出这些花样如果你愿意多花点时间这个扩展的可玩性比想象中高。比如在设置里上传自己的 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考