支持以Markdown格式编写电子邮件并发送

Markdown Here


访问网站
获取 Chrome 版本
获取 Firefox 版本
获取 Thunderbird 版本
获取 Opera 版本

Markdown Here 是一款适用于 Google Chrome、Firefox、Opera 和 Thunderbird 的扩展程序,可让您使用 Markdown 编写电子邮件,并在发送前进行渲染。它还支持语法高亮(只需在分隔的代码块中指定语言即可)。

编写包含代码的电子邮件非常繁琐。编写包含代码的 Markdown 代码则非常简单。我发现自己经常在 GitHub 浏览器内置编辑器中用 Markdown 编写电子邮件,然后将预览复制到电子邮件中。这是一个相当荒谬的工作流程,因此我决定创建一个工具,可以直接在电子邮件中编写和渲染 Markdown。

要了解 Markdown Here 中 Markdown 的用法,请查看 Markdown Here 速查表 和其他 wiki 页面

†:还有 Google 网上论坛帖子、Blogger 帖子、Evernote 笔记和 Wordpress 帖子!查看更多
‡:还有 TeX 数学公式!

安装说明

Chrome

Chrome 网上应用店

前往 Chrome 网上应用店的 Markdown Here 页面 并正常安装。

安装完成后,请务必刷新您的网页邮箱或重启 Chrome!

手册/开发

  1. 克隆此代码库。
  2. 在 Chrome 中,打开“扩展程序”设置。(扳手按钮,工具,扩展程序。)
  3. 在“扩展程序”设置页面,勾选“开发者模式”复选框。
  4. 点击现在可见的“加载解压后的扩展程序…”按钮。导航到您克隆代码库的目录,然后导航到该目录下的 src 目录。
  5. 现在应该可以在您的扩展程序列表中看到 Markdown Here 扩展程序了。
  6. 在尝试转换电子邮件之前,请重新加载您的网络邮件页面(也许还有应用程序)。

Firefox 和 Thunderbird

Mozilla 附加组件网站

前往 Markdown 插件 的 Firefox 附加组件页面 并正常安装。

或者,前往“工具 > 附加组件”菜单,然后搜索“Markdown 插件”。

安装完成后,请务必重启 Firefox/Thunderbird!

注意: Mozilla 最多需要一个月的时间来批准对 Firefox/Thunderbird 扩展的更改,因此更新(功能、修复)将比此处显示的更新慢。您可以在版本列表中手动选择安装最新版本,无需等待审核:https://addons.mozilla.org/en-US/firefox/addon/markdown-here/versions/

手册/开发

  1. 克隆此代码库。
  2. 按照 MDN “您的第一个 Web 扩展” 文章中的说明操作。

Opera

请注意,Markdown Here 仅适用于 Opera 16 及更高版本(即基于 Chromium 的版本)。

前往 Opera 附加组件商店的 Markdown 插件 页面 并正常安装。

安装完成后,请务必重新加载您的网页邮箱或重启 Chrome!

使用说明

安装后……

  1. 在 Chrome/Opera 中,请确保在尝试使用 Markdown 之前重新加载您的网页邮件页面。
  2. 在 Chrome/Firefox/Opera 中,登录您的 Gmail、Hotmail 或 Yahoo 帐户并开始撰写新邮件。在 Thunderbird 中,开始撰写新邮件。
  3. 确保您使用的是富文本编辑器。
  • 在 Gmail 中,点击“富文本格式”链接(如果可见)。
  • 在 Thunderbird 中,确保在“帐户设置”的“撰写和地址”窗格中启用了“以 HTML 格式撰写邮件”。
  1. 使用 Markdown 撰写邮件。例如:
**Hello** `world`.

```javascript
alert('Hello syntax highlighting.');
```
  1. 在撰写框中右键点击,然后从上下文菜单中选择“Markdown 切换”项。或者点击工具栏上显示的按钮。或者使用快捷键(默认为 SHIFT+ALT+M)。
  2. 您应该会看到您的电子邮件从 Markdown 正确渲染为富 HTML 格式。
  3. 将您精彩的电子邮件发送给您认识的所有人。他们看到的邮件将与您看到的邮件一致。

恢复为 Markdown

将 Markdown 渲染为美观的 HTML 后,您仍然可以恢复到原始的 Markdown 格式。只需在新渲染的 Markdown 中的任意位置右键点击,然后点击“Markdown 切换”即可——您的电子邮件正文将恢复为您编写的 Markdown 格式。

请注意,恢复为 Markdown 后,您对美观的 HTML 格式所做的任何更改都将丢失。

在 Gmail 中,您也可以使用浏览器的“撤消”命令(CTRL+Z / CMD+Z,或从“编辑”菜单中选择)。请注意,您输入的最后几个字符也可能会丢失。

回复

在 Gmail、Thunderbird 和 Google 网上论坛中,您可以正常使用“Markdown 切换”:只需撰写回复(顶部、底部、行内或任意位置),然后转换即可。您正在回复的原始电子邮件将保持不变。 (技术层面:现有的 blockquote 区块将保持不变。)

在 Hotmail 和 Yahoo(它们不会将原始内容放入 blockquote 中)以及 Gmail、Thunderbird 和 Google Groups 中(可选),您可以通过选择要转换的内容,然后点击“Markdown 切换”来确保只转换您撰写的回复部分——请参阅下一部分。

选择/分段转换

有时您不想转换整封邮件;有时您的邮件并非完全是 Markdown 格式。要仅转换邮件的部分内容,请选中文本(使用鼠标或键盘),右键单击该文本,然后点击“Markdown 切换”菜单项。您的选择将神奇地呈现为漂亮的 HTML 格式。

要恢复为 Markdown 格式,只需将光标放在转换后的文本块中的任意位置,右键单击,然后再次点击“Markdown 切换”菜单项。现在,它神奇地恢复到了原始的 Markdown 格式。

关于转换/还原选择的须知

  • 如果您只选择文本块的一部分,则只有该文本会被转换。转换后的文本块将被包裹在段落元素中,因此原始行将被拆分。您可能永远都不想这样做。

  • 您可以同时选择并还原多个已转换的文本块。这样做的好处是,您可以选择整封邮件,点击“Markdown 切换”,您已转换的所有内容都将被还原。

  • 如果您在点击“Markdown 切换”时未选择任何内容,Markdown Here 将检查邮件中是否有已转换的文本块并将其还原。如果没有找到已转换的文本块,它将转换整封邮件。

选项

您可以通过 Chrome、Firefox 或 Thunderbird 扩展程序列表访问“Markdown Here 选项”页面。可用选项包括:

  • 修改渲染 Markdown 的样式。
  • 选择和修改语法高亮主题。
  • 启用和自定义 TeX 数学公式处理。
  • 快捷键设置。

对于 Chrome 和 Firefox,在“Markdown Here 选项”中所做的任何更改都会自动同步到您安装的其他浏览器(前提是您在浏览器中启用了同步功能)。

备注及其他

  • Markdown Here 使用 Github 风格 Markdown,但存在一个限制:不支持 GFM 特殊链接 (问题 #11);由于 MDH 并非 Github 专用,因此以后也不会支持。

  • 可以在 highlight.js 演示页面 上查看语法高亮可用的语言(以及它们在围栏代码块中的书写方式)。

  • 启用“Markdown 切换”后,Markdown 中内嵌的图片将会保留。Gmail 允许您在电子邮件中内嵌图片——这比引用外部图片要方便得多。

  • 电子邮件签名将自动从转换中排除。具体来说,半标准“--”符号(注意尾随空格)之后的任何内容都将保留。

  • 请注意,Hotmail 和 Yahoo 不会自动将“--”添加到签名中,因此您必须自行添加。

  • “Markdown 切换”菜单项显示的元素类型超出了其正确渲染的范围。这是为了帮助用户意识到他们没有使用富文本编辑器。否则,他们根本看不到菜单项,也不知道原因。

  • 样式:

  • 应避免使用浏览器特定的样式(-moz-、-webkit-)。如果使用,这些样式可能无法正确渲染,即使用户使用与发送邮件时不同的浏览器阅读邮件。

  • 使用状态相关的样式(例如“a:hover”)不起作用,因为它们在样式明确指定时不匹配。 (在电子邮件中,必须将样式明确应用于所有元素——样式表会被剥离。)

  • 如需更多可调整的功能,请访问技巧和窍门部分。

构建扩展包

复制代码
cd utils
node build.js

Chrome、Opera 和 Firefox (WebExtension) 扩展

创建一个扩展名为 .zip 的文件,其中包含以下文件和目录:

复制代码
manifest.json
common/
chrome/
_locales

后续步骤

请参阅 问题列表Notes Wiki。所有想法、错误、计划、投诉和梦想都会集中在这两个地方之一。

如果您想要的功能尚未存在,请随时创建功能请求问题。如果您希望以更非正式的方式提出想法,请在我们的 GitHub 讨论区 中发帖。

要及时了解所有支持 Markdown Here 的应用程序和网站的最新变化,也需要付出不少努力。

致谢

Markdown Here 是站在巨人的肩膀上编写的。

反馈

欢迎提交任何错误、功能请求、拉取请求、反馈等。创建问题。或发布到我们的 GitHub 讨论区

许可证

代码

MIT 许可证:https://adampritchard.mit-license.org/ 或查看“LICENSE”文件

关于项目

Markdown Here 是一款 Google Chrome、Firefox、Opera 和 Thunderbird 扩展程序,可让您使用 Markdown‡ 撰写电子邮件†,并在发送前进行渲染。它还支持语法高亮(只需在带围栏的代码块中指定语言即可)。
MIT
Javascript
60,037
11186
997
2012-05-13
2025-08-22

增长趋势 - stars