一小時學會Markdown,將思考sync到電腦並發佈到Medium的超快技巧

Illustration by Vera Chang
● 需要準備的工具/軟體:電腦/ Pad,一款支援Markdown的App或線上編輯器。
● 哪些人適合學習?
1.需要寫大量文字的工作者
2.想要作讀書筆記、寫日記、文字創作的人
3.工程師

如果你想提高寫作的順暢度,更專心和簡潔的寫作環境,更容易進入Flow的狀態,那麼你應該需要學會Markdown。

如果本身就有使用文書軟體、有一點編輯 Medium,或是 coding 的經驗,上手速度將會非常快。在聽了第9集的《星箭廣播》後,我決定開始學習 Markdown 語法。

Markdown App 的軟體選擇多,大大提升了寫作的流暢度與速度,對於架構寫作的視覺化也很有幫助。其實在各處都會看到使用 markdown 的例子,例如,Github 上常見的說明文件、最近大熱的筆記軟體 notion 也有支援喔。

本篇文章搜集學習 Markdown 需要的資源與常用語法,希望幫助初學者輕鬆入門。

什麼是 Markdown?

Markdown 的目標是實現「易讀易寫」。

Markdown是一種輕量級標記語言,創始人為 John Gruber。它允許人們「使用易讀易寫的純文本格式編寫文檔,然後轉換成有效的 XHTML 或者 HTML文檔」。一份使用 Markdown 格式撰寫的文件應該可以直接以純文字發佈,並且看起來不會像是由許多標籤或是格式指令所構成。

— Wikipedia & Markdown 文件

目錄
什麼是Markdown?
常用語法
進階語法
Markdown匯入到Medium
資源
・推薦編輯軟體
・更多學習資源

常用語法

🔆 強調語法

  • 斜體 *Italic*
  • 粗體 **Bold**
  • 刪除線 ~~Negative~~
  • 畫重點 ::highlight::

📌 標題

# h1大標
## h2中標
### h3小標

🔢 清單列表

  • 無序清單 * List(星號+空格)
  • 數字列表 1. List(數字+句點+空格)
  • 排序的次清單 ...1.List(點號表示相同數量的空格+數字+句點+空格))
  • 無序的次清單 ...* List(點號表示相同數量的空格+星號+空格)

🖥 程式碼區塊

  • 程式碼 `Code` (2個`中間包文字)
  • 程式碼區塊 (3個`換行,中間包文字)
```
Block
```

📎 其他

  • Check box (-+空格+[ ]+空格)
- [x] Task 1
- [ ] Task 2
  • 連結 [連結標題文字](連結網址)
  • 引文 > Quotation

分隔線 ***, ---, ___(三個以上的符號,必須在獨立的一行,前後不能有其他文字)

  • 插入圖片 ![圖片標題](圖片連結)

進階語法 (少部分App支援)

  • 表格 (可點擊連結Markdown Tables Generator)
  • 流程圖 (可點擊參考詳細教學)
  • 數學式 (可點擊參考詳細教學)
表格 (可點擊連結Markdown Tables Generator)
流程圖 (可點擊參考詳細教學)
數學式 (可點擊參考詳細教學)

Markdown 匯入到 Medium

❶ 直接從編輯 Markdown 文件的軟體複製文字後貼上 Medium,再照著標記變更樣式。

❷ 在stories頁面使用Import a story,從 Github gist 匯入

❸ 使用 Github gist 嵌入內文

❷, ❸ 差別只在最後一個步驟,在 gist 建立新檔案後,從 Medium 匯入或是直接使用嵌入。

👇🏻 下方是 ❷ & ❸ 的步驟:

1. 在 gist.md 的檔案拖入
2. 點選 Creat secret gist Creat public gist 皆可

接下來的步驟是嵌入方式匯入方式的差別。

✅ 匯入文件

1. 複製網頁的 link (藍色箭頭)
2. 從 Medium 的 stories 頁面點選 Import a story 貼上網址就可以完成匯入了。

✅ 嵌入文件

1. 複製藍色框框內的程式碼 “網址” 部分
2. 選擇 < > 符號,將藍色框框內程式碼 “網址” 部分貼上

下方即是嵌入的顯示結果,這個方式有一點很方便,它承續 Github 的版本控制,所以在 Github gist 更新,Medium 裡鑲嵌的內容也會一起變更。

資源

🆓 推薦編輯軟體 — 免費

  • Bear — 高顏值,可付費升級,有較多功能,ex: Tag、筆記互相連結。
  • Typora — 完全免費,介面簡潔,有多款主題,但較陽春。
  • Notion.so — 最近大熱的筆記軟體。不是專門用來撰寫文字,但有多樣的功能連結,且支援markdown語法。

💰 推薦編輯軟體 — 付費

👩🏻‍🏫 教學

更多學習資源

謝謝你看到這裡,歡迎分享!

Hello,我是Vera,目前在 IT 產業工作的 Visual Designer。如果有任何建議或合作提案也可以透過以下這些方式聯繫。BehanceDribbbleWebsite

--

--