写邮件带代码片段是件苦差事:用富文本编辑器缩进、换字体、调颜色,十分钟过去格式还是乱的。有个荒诞的工作流曾流行一时——在 GitHub 网页编辑器里写 Markdown,预览完再把渲染结果复制回邮箱。adam-p 为此写了一个浏览器扩展:Markdown Here,在邮箱编辑框里写 Markdown,右键一点,直接渲染成排版精美的 HTML 邮件。
它支持 Chrome、Firefox、Opera 与 Thunderbird,MIT 许可证,还顺带支持 TeX 数学公式渲染与代码语法高亮。本文从使用体验讲到原理与定制,帮你判断这个十岁老项目如今还值不值得装。
1、是什么
Markdown Here 是一个把"Markdown 渲染"塞进邮件客户端的扩展。用法直白到不需要教程:在 Gmail、Hotmail、Yahoo 的编辑框或 Thunderbird 的新邮件窗口里正常写 Markdown,然后右键菜单点 Markdown Toggle,或按默认快捷键 SHIFT+ALT+M,邮件正文瞬间从纯文本变成带样式的 HTML。
它最贴心的一点是双向可逆:渲染后随时再点一次 Markdown Toggle,正文变回你写的 Markdown 原文。误改了渲染后的 HTML 也不怕,撤销回到 Markdown 重来。对邮件场景它还有个细节设计:自动跳过签名部分——凡是半标准签名标记 '-- ' 之后的内容都不做转换,避免把签名排版弄乱。
适用平台与形式如下:
| 平台 | 安装来源 |
|---|---|
| Chrome | Chrome Web Store |
| Firefox | Mozilla Add-ons |
| Thunderbird | Mozilla Add-ons |
| Opera | Opera Add-ons(需 16+,Chromium 内核) |
除了四大平台,它实际能用的地方更多:Google Groups 帖子、Blogger 文章、Evernote 笔记、WordPress 博文都行——本质上任何富文本编辑框都可以试。
2、正确用法
基础流程三步:装扩展、重载网页邮件页面、在富文本编辑器里写 Markdown 后触发转换。有两个前提条件容易被忽略:Gmail 要确认处于富文本格式,Thunderbird 要在账户设置里启用 HTML 撰写。
部分转换是它的进阶玩法。邮件里不是每段都是 Markdown——选中想转换的文字再点 Markdown Toggle,只有选中部分被渲染;回复邮件时尤其有用,只转换自己写的部分,不碰对方的原始引用。选区转换的规则如下:
| 操作 | 效果 |
|---|---|
| 选中部分文本转换 | 只有选中部分被渲染 |
| 无选区点击转换 | 已转换块变回 Markdown,无转换块则全信转换 |
| 选中整封信再转换 | 所有已转换块统一还原 |
回复场景的处理也分两类:Gmail、Thunderbird 与 Google Groups 会把原信放进 blockquote,直接全信转换不会动原信;Hotmail 与 Yahoo 没有 blockquote 结构,老老实实用选中转换。
代码块要指定语言才有语法高亮,支持的语言以 highlight.js 的演示页为准。图片可以直接内联进 Markdown,在 Gmail 里会作为内嵌图片发出,比引用外链图稳得多。
3、原理与定制
Markdown Here 的渲染链路是三件开源库的拼装:Markdown 转 HTML 用 marked,语法高亮用 highlight.js,HTML 转回纯文本用 jsHtmlToText。这个组合决定了它的能力边界:基于 GitHub Flavored Markdown,但不支持 GFM 的特殊链接语法。
扩展的选项页提供了三层定制能力。样式修改:渲染出的标题、代码块、引用的 CSS 全部可以改,写好一套样式,所有邮件长一个样;高亮主题:内置多套代码高亮配色可选可改;公式渲染:可开关 TeX 数学公式的处理并自定义分隔符。Chrome 与 Firefox 的配置会通过浏览器同步在多台设备间漫游。
邮件场景的 HTML 有个特殊约束:样式必须内联。多数邮件客户端会剥掉 <style> 标签与外部样式表,所以 Markdown Here 把所有样式显式写在元素上——这也是它配置项里提醒不要用 -moz-、-webkit- 前缀和 a:hover 这类状态选择器的原因,跨客户端读信时这些都会失效。
4、现状与替代
诚实地说,这是个进入维护期的项目。它的核心用法十年来没有变过,但依赖与周边在老化:Firefox 官方审核有最长一个月的滞后,急用新版本得手动安装;Thunderbird 在扩展兼容页列出了版本限制;它依赖的邮件服务界面(如 Hotmail、Yahoo Mail)改版频繁,效果需自行验证。
它的正确打开方式是场景互补而非全场景替代:2020 年后 Gmail 与 Outlook 网页版自带了 Markdown 快捷输入(**bold** 这类自动转换),覆盖了最常用的加粗斜体;而 Markdown Here 的不可替代处在于成片的代码块、表格、公式与完全自定义的样式——这些原生编辑器至今做不好。
值的与不值的一张表:
| 场景 | 建议 |
|---|---|
| 经常发带代码的邮件 | 值得装,至今无对手 |
| 只用加粗斜体列表 | 网页版自带功能够用 |
| 需要表格公式渲染 | 值得装,覆盖原生盲区 |
| 追求长期维护活跃度 | 关注官方动态再定 |
5、总结
Markdown Here 用一个右键菜单解决了一个真实且持久的痛点:让写惯了 Markdown 的人不必在富文本编辑器里受折磨。双向可逆、签名保护、部分转换这些细节,能看出作者对邮件场景理解之深;而维护放缓、周边老化,也是十年老项目难以回避的现实。
对于经常在邮件里贴代码、写表格、发公式的开发者,建议装上并花十分钟配置一套自己的邮件样式,受益立竿见影;对于只用基础加粗斜体的轻度用户,建议直接用 Gmail 等自带的 Markdown 快捷输入,不必多装一个扩展;对于团队协作场景,建议统一一套 CSS 样式模板下发,让对外邮件的排版保持一致。


