企业官网建设流程全解析

Markdown Viewer 实战指南：在浏览器里直接渲染公式与图表的 MD 阅读器

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

Markdown Viewer 是开源的 Markdown 浏览器扩展，把本地和网络上的 .md 文件直接渲染成带语法高亮、公式与图表的排版页面，免去复制粘贴到在线渲染器的麻烦。适合常读 README、技术文档的人。

能力总览

功能	一句话说明	默认状态
语法高亮	围栏代码块按语言着色，覆盖 300 多种语言	开启
公式渲染	MathJax 渲染行内与块级 LaTeX	关闭
图表渲染	Mermaid 流程图、时序图，可缩放与平移	关闭
目录生成	按标题生成可点击的 ToC	关闭
自动重载	本地文件每秒检测一次变更并刷新	关闭
主题与宽度	30 多个内置主题，宽度 7 档	内置 github 主题
Emoji	简写转为 EmojiOne 图标	关闭

日常真正高频用的是语法高亮和主题宽度：前者默认开启，读代码密集的文档基本不用动；后者决定阅读舒适度，auto 档在 github 主题下与 GitHub 仓库的 README 渲染效果一致。公式和图表默认都是关的，不手动打开就不会渲染——这也是"功能失效"误会最常见的来源。

⚙️ 从安装到可用

1. 从浏览器商店安装（支持 Chrome、Firefox、Edge 等），或下载 release 里的 .crx / .zip 手动加载
2. 打开扩展管理页，找到 Markdown Viewer，点"详细信息"
3. 打开Allow access to file URLs开关——本地文件能不能读全看它
4. 用 file:// 地址打开任意 .md 文件，验证渲染效果
5. 点工具栏图标打开快速设置面板，选主题、宽度，按需打开 mathjax、mermaid 等开关
6. 要读远程网站的 Markdown，在高级选项页把对应源（origin）加入白名单

本地文件权限怎么开，就是第 2、3 步：扩展管理页 → 详细信息 → 文件网址开关。很多人装完漏掉这一步，之后打开本地文档没有任何反应。Firefox 版流程略有差异，仓库里的 firefox.md 有单独说明。

远程源默认一律不授权，这是有意设计。授权支持通配符：*://raw.githubusercontent.com一次覆盖 http 和 https，http://localhost:3000可以精确到端口，每个源还能单独配置内容检测。

宽度共 7 档，按屏幕大小选即可：

📐 进阶能力拆解

MathJax 公式渲染配置

面板里打开mathjax开关后，行内公式写\(E = mc^2\)或$E = mc^2$，块级公式写$$ … $$。正文里的普通美元符号要转义成\$，否则会被当成公式定界符吃掉。

Mermaid 图表

把图写进mmd或mermaid围栏代码块即可，最小例子：

渲染出的图表支持拖右下角改容器高度、Shift 加滚轮缩放、左键拖拽平移，看大图不用导出来。

解析器选择

面板可切换解析器，各自带独立的选项面板（abbr、breaks、tasklists、footnote 等 15 项）：

markdown-it 的开关里 html 和 linkify 默认打开，其余按需勾选即可，一般不必逐个研究。

自定义主题怎么上传

高级选项页把主题选成 custom，上传自己的 .css 文件，再指定 light 或 dark 配色。上传时会自动压缩，上限 8KB，超限会在页面上直接报错。适合团队统一阅读样式，或把某个内置主题微调后固化下来。

🔧 踩坑与效率

本地 .md 打开没有渲染 → 文件访问权限没开 → 回扩展详情页打开Allow access to file URLs，高级选项页里也会出现 Allow Access 快捷按钮。

开启公式后正文的 $ 显示异常 → MathJax 把$当成了定界符 → 正文美元改写成\$；注意\(这类转义括号 MathJax 不认，用反引号包住更稳。

换设备后授权源高亮、不可用 → 同步同步的是偏好设置，权限本身不跨设备 → 在高级选项页点高亮源旁边的Refresh重新授权。

效率组合：

• 写文档时开autoreload，它只对 file:// 和 localhost 生效，改完秒级刷新
• 长文档开toc，配合标题锚点跳转；短文档关掉更清爽
• 权限只加需要的域名：精确 URL 优先于*://*；每个源可单独调内容检测（content-type 头加路径正则，默认匹配 .md 等 9 种扩展名）
• 团队场景用自定义主题加固定宽度，保证所有人看到的排版一致

关键文件索引

• README.md：功能清单、权限与主题说明
• popup/：快速设置面板，主题、宽度、解析器、内容开关都在这
• options/：高级选项页，含自定义主题上传
• background/compilers/：解析器模块
• content/themes.css：内置主题样式

打开扩展图标面板，先勾上 mathjax 和 toc，宽度选 wide，日常文档阅读就能跑起来了。

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