功能介紹
Markdown 預覽是一個即時 Markdown 編輯器。在左邊輸入,右邊就會隨打即顯示算繪結果:標題、清單、連結、圖片、表格、程式碼區塊和引用。很適合在提交前先草擬 README、版本說明、部落格文章或技術文件,也能檢查複雜的表格或巢狀清單最後會長什麼樣子。
把檢視切換到 HTML 可以看到產生的標記,接著可以複製它,或下載一個帶有基本樣式的完整 HTML 頁面。
使用方式
- 在輸入框中輸入或貼上 Markdown、把
.md檔案拖曳進來,或按 範例。 - 預覽會隨著輸入即時更新。上方那一行會顯示字數、標題數和連結數。
- 選擇 預覽 檢視算繪後的頁面,或選擇 HTML 檢視標記。
- 用 複製 HTML 把結果貼到 CMS 或電子郵件,或用 下載 HTML 取得獨立檔案。
Markdown 語法速查表
| 你輸入 | 你會得到 |
|---|---|
# Title | 一級標題(## 為二級,最多到 ######) |
**bold** 和 _italic_ | 粗體 和 斜體 |
[text](https://example.com) | 連結 |
 | 圖片 |
- item 或 1. item | 項目符號清單或編號清單 |
- [ ] todo | 任務清單核取方塊(GFM) |
`code` | 行內程式碼 |
單獨一行的 ```js | 標明語言的圍欄程式碼區塊 |
> quote | 區塊引用 |
--- | 水平分隔線 |
表格使用直線符號和分隔列:先寫 | a | b |,下一行接 | --- | --- |。表格是 GitHub 風格 Markdown 的擴充語法,不屬於 CommonMark,所以只有開啟 GitHub 風格 Markdown 時才會算繪成表格;關閉後會以一般文字顯示,直線符號原樣保留。
範例
## Highlights
- [x] Tables and task lists
- ~~Old API~~ removed
會算繪成一個二級標題,後面接著一個已勾選的任務項目,以及一行被刪除線劃掉的文字。
常見問題
› 支援哪些 Markdown 語法?
CommonMark 加上 GitHub 風格 Markdown(GFM):表格、任務清單、刪除線、圍欄程式碼區塊和自動連結。關閉 GFM 可以看看嚴格的 CommonMark 算繪器會怎麼顯示你的文字。
› 貼上含有 HTML 的 Markdown 安全嗎?
安全。Markdown 允許直接寫 HTML,所以預覽會顯示在沙箱框架中,指令碼無法執行。不過複製出去的 HTML 沒有經過淨化,若要在自己的網站上發布不受信任的內容,請先清理過再發布。
› 為什麼單一換行不會另起一行?
在標準 Markdown 中,單一換行會被當成空格,空一行才會開始新段落。開啟「單一換行轉為 <br>」後,每個換行都會算繪成換行,和 GitHub 留言的行為一樣。
› 我的文字會被儲存嗎?
最後一次的輸入會保留在這個瀏覽器的 localStorage 中,重新整理頁面後仍在。內容永遠不會上傳,你可以用「清除」按鈕清掉它。