使用說明

Markdown 編輯器:邊寫邊看,複製 HTML

這個 Markdown 編輯器會在你的文字旁邊顯示排版後的結果,停止輸入約 50 毫秒後就會更新。它支援 GitHub Flavored Markdown:標題、粗體、斜體、刪除線、清單、任務清單、表格、引用、連結、圖片,以及帶顏色的程式碼區塊。你的文字只留在這個瀏覽器中,輸入時會儲存在這個裝置上。


Markdown 線上編輯器怎麼用

  1. 在 Markdown 輸入方塊中輸入或貼上 Markdown。第一次開啟時裡面有一小段範例,你可以選取後刪除。
  2. 視窗夠寬時,預覽會顯示在編輯器旁邊。在手機或較窄的視窗中,請在 編輯 與 預覽 兩個分頁之間切換。
  3. 邊寫邊看預覽。還沒輸入任何內容時,會顯示「目前沒有可預覽的內容。請輸入一些 Markdown。」
  4. 要原始文字就按 複製 Markdown,要轉換後的標記就按 複製 HTML,要儲存文章.md 就按 下載 .md。按鈕上方的小提示會顯示「已複製 Markdown」、「已複製 HTML」或「已下載」。
  5. 之後再回來,你的文字還在:它儲存在這個瀏覽器中,而不是伺服器上。

方塊是空的時候,三個按鈕都無法使用。

Markdown 表格語法與任務清單

表格需要一列標題、一列由短橫線組成的分隔列,接著是資料列。直線不必對齊:| 名稱 | 職務 |,下面是 | --- | --- |,再下面是 | Ada | 工程師 |。

任務清單的寫法是,未完成的項目以 - [ ] 開頭,已完成的以 - [x] 開頭。預覽會畫出兩欄的表格,接著列出每個任務,並各附一個勾選方塊。

Markdown 程式碼區塊與語法上色

用三個反引號加上語言名稱開啟區塊,從下一行開始寫程式碼,最後在單獨一行用三個反引號結束。例如 ```js 會開啟 JavaScript 區塊。

預覽會為 JavaScript、TypeScript、JSX、TSX、JSON、HTML 與 XML、CSS、Bash、Python、YAML、SQL、diff、Markdown、C、Java、Go 和 Rust 上色。常見的簡稱 js、ts、py、sh、yml 和 html 也能使用。沒有指定語言,或語言不在清單內的區塊,會顯示為沒有顏色的一般程式碼。

Markdown 轉 HTML 與 md 檔案建立

複製 Markdown會把你輸入的原始文字放進剪貼簿,適合貼到 README、GitHub issue 或筆記軟體。複製 HTML會把轉換並清理過的 HTML 以格式化文字和純文字兩種形式複製,所以貼到 Gmail、Word 或 Google 文件時會保留格式,貼到程式碼編輯器或 CMS 時則是標記碼。

要建立 md 檔案,請使用下載 .md:你會得到以 UTF-8 文字儲存的文章.md,可以留作備份,或把文字帶到另一台電腦。複製出來的 HTML 不含 CSS,所以標題、表格和程式碼會採用貼上位置的樣式。預覽樣式不會改變複製的內容。

版面配置、預覽樣式與外觀

按鈕下方的設定按鈕會顯示「分割檢視 · 預設」之類的摘要,按下後會開啟編輯器設定:

選擇完成即可關閉設定面板。

貼上的 HTML 不會執行程式碼

Markdown 可以包含原始 HTML,所以結果在顯示或複製之前會先經過清理。指令碼、onclick 之類的事件屬性,以及 javascript: 連結都會被移除。你可以放心貼上來自任何地方的文字,不用擔心它在預覽或你複製的 HTML 中執行任何東西。

這個編輯器刻意保持精簡:沒有格式工具列,也沒有粗體或斜體的鍵盤快速鍵,所以符號要自己輸入。兩個窗格不會同步捲動,你無法開啟檔案,只能貼上文字,沒有雲端同步,而且每個瀏覽器只會儲存一份草稿。這裡也不能匯出 PDF 或 Word:要產生 PDF,請使用 Markdown 轉 PDF。


常見問題

Markdown 預覽要怎麼在線上看?

在「Markdown 輸入」方塊中輸入或貼上 Markdown。停止輸入約 50 毫秒後,預覽就會重新繪製:視窗夠寬時在編輯器旁邊,視窗較窄時在「預覽」分頁下。你不需要先儲存或送出任何東西,文字也不會被傳送到任何地方。

要怎麼把 Markdown 複製成 HTML?

按編輯器下方的「複製 HTML」。它會把轉換並清理過的 HTML 以格式化文字和純文字兩種形式複製,所以貼到 Gmail、Word 或 Google 文件時會保留格式,貼到程式碼編輯器時則是標記碼。它不含 CSS,貼上後的外觀會依貼上的位置而定。「複製 Markdown」則是複製你原本的文字。

Markdown 要怎麼做表格?

先寫一列標題,儲存格之間用直線隔開,接著寫一列由短橫線組成的分隔列,然後每筆資料一列:| 名稱 | 職務 |,接著 | --- | --- |,再接著 | Ada | 工程師 |。只要有了分隔列,預覽就會畫成表格。

Markdown 的任務清單要怎麼寫?

項目以 - [ ] 開頭表示未完成,以 - [x] 開頭表示已完成,右中括號後面要留一個空格。例如 - [x] 寫完草稿 和 - [ ] 寄出。預覽會為每個項目顯示一個勾選方塊。

Markdown 的程式碼區塊要怎麼指定語言?

把語言名稱直接寫在開頭的三個反引號後面,例如 ```js 或 ```python,並在單獨一行用三個反引號結束區塊。預覽會為 JavaScript、TypeScript、JSX、TSX、JSON、HTML 與 XML、CSS、Bash、Python、YAML、SQL、diff、Markdown、C、Java、Go 和 Rust 上色。js、ts、py、sh、yml 這類簡稱也可以。不在清單內的語言會顯示為沒有顏色的一般程式碼。

可以把 Markdown 以格式化文字貼到 Gmail 或 Word 嗎?

可以。按「複製 HTML」,再貼到郵件或文件中。標題、粗體、清單、連結和表格都會帶著格式貼上,因為剪貼簿除了標記碼,也存了格式化文字。如果貼到純文字欄位,看到的會是 HTML 標記碼。

這是所見即所得的 Markdown 編輯器嗎?

不是。你在純文字方塊中輸入 Markdown,再從旁邊的預覽讀取排版後的結果。這裡沒有格式工具列,也沒有粗體或斜體的鍵盤快速鍵,所以符號要自己輸入,例如在粗體文字前後各加 **。

編輯器支援 Mermaid 圖表或 LaTeX 嗎?

不支援。預覽只會呈現 GitHub Flavored Markdown。標示為 mermaid 或 latex 的區塊會顯示為一般程式碼,不會畫成圖表或公式。

我的文字會被儲存或上傳嗎?

只會儲存在這個裝置上。編輯器會在你輸入時把文字存在這個瀏覽器中,所以重新整理或關閉分頁都不會遺失,也不會有任何內容傳送到伺服器。如果你清除 capsuletools.app 的網站資料,文字就會消失。每個瀏覽器只會儲存一份草稿。

可以在這裡把 Markdown 轉成 PDF 嗎?

這個編輯器不行。它可以複製 Markdown 或 HTML,也能下載 .md 檔,但不能匯出 PDF 或 Word。要產生 PDF,請把同樣的文字貼到 Markdown 轉 PDF 工具,那裡有專用的頁面主題。