造訪網站。
獲取 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) 許可證