访问网站
获取 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 网上应用店的 Markdown Here 页面 并正常安装。
安装完成后,请务必刷新您的网页邮箱或重启 Chrome!
src
目录。前往 Markdown 插件 的 Firefox 附加组件页面 并正常安装。
或者,前往“工具 > 附加组件”菜单,然后搜索“Markdown 插件”。
安装完成后,请务必重启 Firefox/Thunderbird!
注意: Mozilla 最多需要一个月的时间来批准对 Firefox/Thunderbird 扩展的更改,因此更新(功能、修复)将比此处显示的更新慢。您可以在版本列表中手动选择安装最新版本,无需等待审核:https://addons.mozilla.org/en-US/firefox/addon/markdown-here/versions/
请注意,Markdown Here 仅适用于 Opera 16 及更高版本(即基于 Chromium 的版本)。
前往 Opera 附加组件商店的 Markdown 插件 页面 并正常安装。
安装完成后,请务必重新加载您的网页邮箱或重启 Chrome!
安装后……
**Hello** `world`. ```javascript alert('Hello syntax highlighting.'); ```
将 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 选项”页面。可用选项包括:
对于 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
创建一个扩展名为 .zip
的文件,其中包含以下文件和目录:
manifest.json
common/
chrome/
_locales
请参阅 问题列表 和 Notes Wiki。所有想法、错误、计划、投诉和梦想都会集中在这两个地方之一。
如果您想要的功能尚未存在,请随时创建功能请求问题。如果您希望以更非正式的方式提出想法,请在我们的 GitHub 讨论区 中发帖。
要及时了解所有支持 Markdown Here 的应用程序和网站的最新变化,也需要付出不少努力。
Markdown Here 是站在巨人的肩膀上编写的。
欢迎提交任何错误、功能请求、拉取请求、反馈等。创建问题。或发布到我们的 GitHub 讨论区。
MIT 许可证:https://adampritchard.mit-license.org/ 或查看“LICENSE”文件。