访问网站。
获取 Chrome 版。
获取适用于 Firefox 的版本。
为 Safari 获取它。
为雷鸟获取它。
获取 Opera 版本。
在 GitHub 讨论中讨论并提出问题。
Markdown Here是一个 Google Chrome、Firefox、Safari、Opera 和 Thunderbird 扩展,可让您在Markdown中编写电子邮件†并在发送前渲染它们。它还支持语法突出显示(只需在围栏代码块中指定语言)。
编写包含代码的电子邮件非常乏味。用其中的代码编写 Markdown 很容易。我发现自己在 GitHub 浏览器内编辑器中用 Markdown 编写电子邮件,然后将预览复制到电子邮件中。这是一个相当荒谬的工作流程,因此我决定创建一个工具来直接在电子邮件中编写和呈现 Markdown。
要了解Markdown Here中的 Markdown 可以做什么,请查看 Markdown Here Cheatsheet 和其他 wiki 页面。
†:还有 Google Groups 帖子、Blogger 帖子、Evernote 笔记和 Wordpress 帖子!查看更多。
‡:还有 TeX 数学公式!
安装说明
使用说明
故障排除
兼容性
注释和杂项
构建扩展包
后续步骤、学分、反馈、许可证
前往 Chrome Web Store 页面获取Markdown Here并正常安装。
安装后,请确保重新加载您的网络邮件或重新启动 Chrome!
src
目录。转到Markdown Here的 Firefox Add-ons 页面并正常安装。
或者转到“工具 > 附加组件”菜单,然后搜索“Markdown Here”。
安装后,请务必重新启动 Firefox/Thunderbird!
注意: Mozilla 最多需要一个月的时间来批准对 Firefox/Thunderbird 扩展的更改,因此更新(功能、修复)将落后于此处显示的内容。您可以在从版本列表中查看最新版本之前手动选择安装:https://addons.mozilla.org/en-US/firefox/addon/markdown-here/versions/
直接下载扩展程序。下载完成后,双击进行安装。
要访问 Markdown Here 首选项,请打开 Safari 首选项,然后转到“扩展”选项卡。然后单击“单击我以在此处显示 Markdown 选项”框。
请注意, Markdown Here仅适用于 Opera 版本 16 及更高版本(即基于 Chromium 的版本)。
前往Markdown Here的 Opera Add-ons 商店页面并正常安装。
安装后,请确保重新加载您的网络邮件或重新启动 Chrome!
安装它,然后...
在 Chrome/Safari/Opera 中,请确保在尝试使用 Markdown Here 之前重新加载网络邮件页面。
在 Chrome/Firefox/Safari/Opera 中,登录您的 Gmail、Hotmail 或 Yahoo 帐户并创建新电子邮件。在 Thunderbird 中,开始一条新消息。
确保您使用的是丰富的编辑器。
在 Markdown 中撰写电子邮件。例如:
**你好**`世界`。 ```javascript alert('Hello 语法高亮。'); ````
右键单击撰写框,然后从上下文菜单中选择“Markdown Toggle”项。或者单击地址栏中显示的按钮。或者使用热键(默认为CTRL + ALT + M )。
您应该会看到您的电子邮件从 Markdown 正确呈现为丰富的 HTML。
将您精彩的电子邮件发送给您认识的每个人。他们对他们的看法就像对你的看法一样。
将 Markdown 渲染为漂亮的 HTML 后,您仍然可以返回原始 Markdown。只需右键单击新呈现的 Markdown 中的任意位置,然后单击“Markdown 切换”——您的电子邮件撰写正文将变回您编写的 Markdown。
请注意,当您恢复到 Markdown 时,您对漂亮 HTML 所做的任何更改都将丢失。
在 Gmail 中,您还可以使用浏览器的撤消命令( CTRL + Z / CMD + Z ,或从“编辑”菜单)。请注意,您还可能会丢失最后输入的几个字符。
在 Gmail、Thunderbird 和 Google Groups 中,您可以正常使用“Markdown Toggle”:只需写下您的回复(顶部、底部、内联、任何位置),然后进行转换。您要回复的原始电子邮件将被保留。 (从技术上讲:现有的blockquote
块将保持不变。)
在 Hotmail 和 Yahoo(不将原始内容放在blockquote
中)以及 Gmail、Thunderbird 和 Google 网上论坛(可选)中,您可以通过选择要转换的内容来确保仅转换您所编写的回复部分然后单击“Markdown Toggle”——请参阅下一节。
有时您不想转换整个电子邮件;有时您的电子邮件并不完全是 Markdown。要仅转换电子邮件的一部分,请选择文本(使用鼠标或键盘),右键单击它,然后单击“Markdown Toggle”菜单项。您的选择会神奇地呈现为漂亮的 HTML。
要恢复到 Markdown,只需将光标放在转换后的文本块中的任意位置,右键单击,然后再次单击“Markdown Toggle”菜单项。现在它神奇地回到了原来的 Markdown。
如果您仅选择文本块的一部分,则只会转换该文本。转换后的块将被包装在段落元素中,因此原始行将被分解。您可能永远不想这样做。
您可以同时选择并恢复多个转换后的块。这样做的好处之一是,您可以选择整个电子邮件,单击“Markdown Toggle”,您已转换的所有部分都将被还原。
如果您在单击“Markdown Toggle”时没有选择任何内容, Markdown Here将检查消息中的任何位置是否有转换后的块并还原它们。如果没有找到转换的块,它将转换整个电子邮件。
可以通过 Chrome、Firefox、Safari 或 Thunderbird 扩展列表访问Markdown Here选项页面。可用的选项包括:
对于 Chrome 和 Firefox,在“Markdown Here选项”中所做的任何更改都会在该浏览器的其他安装之间自动同步(如果您在浏览器中启用了同步功能)。
请参阅疑难解答 wiki 页面。
请参阅兼容性 wiki 页面。
Markdown 这里使用 Github Flavored Markdown,但不支持 GFM 特殊链接(issue #11);也不会,因为 MDH 不是特定于 Github 的。
语法突出显示的可用语言(以及它们在隔离代码块中的编写方式)可以在highlight.js 演示页面上看到。
当您“Markdown 切换”时,将保留 Markdown 中内嵌的图像。 Gmail 允许您将图像内联放入电子邮件中 - 这比引用外部图像容易得多。
电子邮件签名会自动排除在转换之外。具体来说,半标准'-- '
(注意尾随空格)之后的任何内容都将被保留。
'-- '
,因此您必须自行添加。“Markdown Toggle”菜单项显示的元素类型多于它可以正确呈现的元素类型。这是为了帮助人们意识到他们没有使用丰富的编辑器。否则他们只是看不到菜单项并且不知道为什么。
造型:
a:hover
)不起作用,因为它们在样式明确时不匹配。 (在电子邮件中,样式必须显式应用于所有元素——样式表将被删除。)有关更多调整功能,请访问提示和技巧部分。
cd utils
node build.js
创建一个扩展名为.zip
的文件,其中包含以下文件和目录:
manifest.json
common/
chrome/
_locales
创建一个扩展名为.xpi
的文件,其中包含以下文件和目录:
chrome.manifest
install.rdf
common/
firefox/
浏览器特定的代码位于markdown-here-safari
项目中。
使用 Safari 扩展生成器。
请参阅问题列表和 Notes Wiki。所有的想法、错误、计划、抱怨和梦想最终都会出现在这两个地方之一。
如果您想要的功能尚不存在,请随意创建功能请求问题。如果您更喜欢采用不太正式的方法来提出想法,请发布到我们的 GitHub 讨论区。
还需要做相当多的工作才能了解 Markdown Here 运行的所有应用程序和网站的最新变化。
Markdown Here是站在巨人的肩膀上编码的。
欢迎所有错误、功能请求、拉取请求、反馈等。创建一个问题。或者发布到 GitHub 讨论区。
MIT 许可证:https://adampritchard.mit-license.org/ 或查看LICENSE
文件。
版权所有 2015,奥斯汀·安德森。根据 MDH 贡献者许可协议向 Markdown Here 授予许可。
知识共享署名 3.0 未移植 (CC BY 3.0) 许可证