markdown-viewer 完整实用指南:浏览器 Markdown 渲染插件从装好到用好 📅 发布时间:2026/8/27 1:15:06 👁 浏览次数: markdown-viewer 完整实用指南浏览器 Markdown 渲染插件从装好到用好【免费下载链接】markdown-viewerMarkdown Viewer / Browser Extension项目地址: https://gitcode.com/gh_mirrors/ma/markdown-viewermarkdown-viewer 是一款浏览器扩展能把本地和线上的 .md 文件直接渲染成排版规整的网页。它内置五款解析引擎、30 多套主题还带代码高亮、公式和图表。这篇指南带你走完克隆、授权、选型的每一步省掉反复翻文档和瞎试的时间。最快 3 分钟装好 Markdown 浏览器插件 第一步克隆源码git clone https://gitcode.com/gh_mirrors/ma/markdown-viewer第二步加载进浏览器。Chrome 系Edge、Brave、Opera、Vivaldi 同理打开chrome://extensions开启右上角开发者模式点加载已解压的扩展程序选中刚克隆的目录。Firefox打开附加组件管理器选从文件安装附加组件指向项目目录更细的差异见 firefox.md。第三步打开关键开关。点扩展图标进入详情页Chrome 系是详细信息把Allow access to file URLs允许访问文件网址拨到开启。现在双击任何本地.md文件地址栏是file:///开头页面就自动渲染成排版好的文档。手动加载的扩展不会自动收到更新想换新版本就重新克隆、重新加载一遍。按场景选配置解析器、主题、宽度怎么选点工具栏图标展开面板主题、解析器、内容选项分成三个标签页。互斥选项就三组可选项特点适合什么时候用markdown-it解析器GFM 表格、删除线、任务列表、脚注等扩展语法都能开技术文档、README扩展语法多marked解析器体积小、渲染快结构简单的短文档remark解析器基于 AST能二次加工文档结构给文档做结构化输出的开发者commonmark解析器严格对齐 CommonMark 规范讲究标准兼容的正式场合showdown解析器输出 HTML 规整、好集成要把结果嵌进别的页面github / github-dark主题共 30 多套还支持上传自定义自带边框的卡片式排版接近仓库里渲染 README 的效果写项目文档water / sakura / latex 等主题轻量、风格化个人笔记、论文草稿auto宽度共 7 档跟随屏幕自适应大多数场景的稳妥选择full / wide / large宽度100% / 1400px / 1200px大屏展示、长文档medium / small / tiny宽度992px / 768px / 576px窄窗口、快速扫读默认推荐组合markdown-it github 主题 auto 宽度日常文档基本不用动。想换扩展语法脚注、任务列表、高亮标记等就切到 compiler 标签页里逐个拨开关。权限与白名单远程站点怎么授权这个扩展走的是默认全拒绝装完后它碰不到你任何内容每一次访问都要你手动放行这是它安全设计的前提。放行分两条线。本地文件线装完必须去扩展详情页把Allow access to file URLs打开——漏了它本地文档依旧打不开。Firefox 默认放行本地文件但 Linux 上要先配好.md的 mime 类型否则会触发下载而不是渲染做法见 firefox.md。远程站点线点工具栏图标 → Advanced Options高级选项把网址粘进 Site Access 输入框点 Add。三个可以直接照抄的写法*://raw.githubusercontent.comhttp 和 https 一次放行https://*.githubusercontent.com该域名下所有子域http://localhost:3000本地开发服务器的固定端口每个已授权站点下面还有两个检测开关响应头检测识别text/markdown、text/plain和路径正则匹配默认正则能认出.md、.markdown、.mdown、.mkd等后缀带#锚点或?查询串也能命中。白名单会随浏览器账号同步过去但真正的授权动作没法同步——新设备上被高亮列出的站点点一下Refresh即可恢复。进阶开关与排障速查按你要什么就开什么的对应关系来要公式内容选项里开mathjax。行内用\(...\)或$...$独立公式用\[...\]或$$...$$正文里普通美元符号必须写成\$反引号包起来的内容则不受影响。要图表开mermaid把图画在mmd或mermaid围栏代码块里。渲染完可以拖代码块右下角拉高容器按住 Shift 滚轮缩放按住左键拖动平移。要代码高亮syntax默认就是开的围栏代码块覆盖 200 多种语言一般不用管。要目录开toc文档标题自动生成导航长文跳转不再靠手滚。要边改边看开autoreload它每秒检查一次file:///和 localhost 上的文件变化本地改完立刻刷新页面。遇到状况先查这张表症状元凶一招解决本地 .md 打不开文件访问权限没开扩展详情页打开允许访问文件网址Firefox 里点 .md 直接触发下载Linux 上 mime 类型不对按 firefox.md 配 text/plain 映射重启浏览器公式显示不出来MathJax 没开或$没转义打开 mathjax 开关正文美元符号改\$远程站点白屏站点没授权或授权已失效高级选项里补通配符高亮条目点 Refresh换主题没反应缓存或配置乱了硬刷新页面面板里点 Defaults 恢复默认再切团队协作者多的话把下面这份配置当模板发给所有人保证大家打开同一份文档看到同一种排版{ compiler: markdown-it, theme: github-dark, width: wide, mathjax: true, mermaid: true, syntax: true, toc: true }安全习惯只有一条原则只给真正要用的站点开权限别点 Allow All。阅读来路不明的文档时把编译器选项里的html开关关掉避免源文档夹带的标签被渲染执行。最后记得定期重新克隆源码、覆盖加载让安全修复及时跟上。【免费下载链接】markdown-viewerMarkdown Viewer / Browser Extension项目地址: https://gitcode.com/gh_mirrors/ma/markdown-viewer创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考