一小時學會Markdown,將思考sync到電腦並發佈到Medium的超快技巧
● 需要準備的工具/軟體:電腦/ 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
分隔線 ***
, ---
, ___
(三個以上的符號,必須在獨立的一行,前後不能有其他文字)
- 插入圖片
![圖片標題](圖片連結)
Markdown 匯入到 Medium
❶ 直接從編輯 Markdown 文件的軟體複製文字後貼上 Medium,再照著標記變更樣式。
❷ 在stories
頁面使用Import a story
,從 Github gist 匯入
❸ 使用 Github gist 嵌入內文
❷, ❸ 差別只在最後一個步驟,在 gist 建立新檔案後,從 Medium 匯入或是直接使用嵌入。
👇🏻 下方是 ❷ & ❸ 的步驟:
接下來的步驟是嵌入方式和匯入方式的差別。
✅ 匯入文件
stories
頁面點選 Import a story
貼上網址就可以完成匯入了。✅ 嵌入文件
下方即是嵌入的顯示結果,這個方式有一點很方便,它承續 Github 的版本控制,所以在 Github gist 更新,Medium 裡鑲嵌的內容也會一起變更。
資源
🆓 推薦編輯軟體 — 免費
- Bear — 高顏值,可付費升級,有較多功能,ex: Tag、筆記互相連結。
- Typora — 完全免費,介面簡潔,有多款主題,但較陽春。
- Notion.so — 最近大熱的筆記軟體。不是專門用來撰寫文字,但有多樣的功能連結,且支援markdown語法。
💰 推薦編輯軟體 — 付費
👩🏻🏫 教學
- 筆記軟體 Bear:簡潔筆記庫+寫作軟體
- 超讚的markdown編輯器-Typora使用心得
- 矽谷大受歡迎的筆記軟體:Notion.so
- Mac上的Markdown文書編寫軟體,尤里西斯 Ulysses
- Ulysses vs. iA Writer: A New Comparison
更多學習資源
- Markdown 語法說明
- Markdown 台灣公開社團
- 一份简明的 Markdown 笔记与教程 — 码志
- 對星箭廣播兩位編輯使用哪些寫作軟體,以及HackMD 開發的故事可以收聽。星箭廣播 Episode 6 和 Episode 9