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

📅 2026/8/15 13:35:16
还在被 Markdown 乱码折磨?5 分钟上手 Markdown Viewer,让浏览器秒变专业阅读器
还在被 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然后打开 ChromeEdge、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创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考