Markdown 是一種「輕量級」標記語言,它允許人們使用易讀易寫的「純文本格式」編寫文檔,然後轉換成有效的 HTML 文檔。
❞❝由於 Markdown 的輕量化、易讀易寫特性,並且對於圖片,圖表、數學式都有支持,目前許多網站都廣泛使用 Markdown 來撰寫幫助文檔或是用於論壇上發表消息。如 「GitHub」、Reddit、Diaspora、Stack Exchange、OpenStreetMap 、SourceForge、「簡書」等,甚至還能被使用來撰寫「電子書」。
❞Markdown 基本語法關於 Markdown 基本語法的資料,在網上隨便一找就是一大把。這裡便不再贅述了。下面列舉了一些教程資源,可以看一下。
其實,Markdown 語法十分簡單,主要我們掌握以下幾個就可以足以應付絕大多數的場景了。
Markdown 書寫規範及排版指南儘管 Markdown 語法很簡單,但是想要寫出一份美觀、易維護的 Markdown 文檔,還是要注意其寫作規範。
Markdown 書寫規範Markdown書寫風格指南[5]裡有對 Markdown 書寫風格詳細介紹,看起來可能比較繁瑣,簡單來說,應該注意以下幾點:
標題 前後都要空 1 行(除非標題在開頭),#與標題文本之間「有且只有一個」空格,標題結尾處不要有空格和標點符號,不能用標題語法來代替正文中的加粗或強調等,同時也不能用加粗或強調等代替標題,標題應該儘可能簡短,方便引用
文字排版指南文字排版是一門藝術,好的排版就是好的設計,尤其對於中文文案排版而言,有不少地方需要注意。
少數派寫作排版指南[6]、中文文案排版指北[7]裡很詳細的說明了中文排版應該注意的技巧。
Markdown 編輯器一覽在線❝市面上在線 Markdown 編輯器很多,界面和功能也是大同小異。
❞馬克飛象[8]:專為印象筆記(Evernote)打造的 Markdown 編輯器,配合印象筆記強大的存儲和同步功能,可極大提升寫作體驗StackEdit[9]:同步是 StackEdit 最大的特性之一,它可以同步工作空間的任何文件到 Dropbox、GitHub、Gitlab 或 Google Drive 中,更大程度地保證了用戶寫作的「隨地性」、與別人協作的「便捷性」Typora[19] 是一款簡潔高效、功能全面、執行優雅的全平臺 Markdown 編輯器,也是目前最受歡迎本地 Markdown 編輯器之一(尤其是在 Windows 下)。它將源碼編輯和實時預覽合二為一,真正實現了「所見即所得」的渲染效果,給予作者極高的沉浸體驗。
Typora 主要特性
下載安裝下載地址[20]
安裝完成之後,啟動 Typora。點擊上方幫助菜單下的任意二級菜單,即可學習相應的 Typora 使用技巧,點擊視圖,還可以切換文件、文件樹、大綱三種視圖模式。
Typora 默認內置 6 款主題,可以通過點擊菜單欄上的「主題」進行切換。
也可通過Ctrl + ,,打開偏好設置 -> 外觀 -> 獲取主題,進入官網主題商店[21]獲取近 60 款(截止到 2021 年 1 月底)漂亮主題。
支持導出的文件格式豐富Pandoc[22] 是標記語言轉換工具,可以實現不同標記語言的格式轉換。
Typora 支持導出的文件格式極為豐富。但如果不安裝 Pandoc,僅支持導出 HTML、PDF 格式的文件;安裝 Pandoc 後,則可支持的文件格式如下:
導入文件格式:.docx/.latex/.tex/.ltx/.rst/.rest/.org/.wiki/.dokuwiki/.textile/.opml/.epub等
導出文件格式:HTML/PDF/Word/OpenOffice/Rtf/ epub/latex/mediawiki/png等
Pandoc 的下載安裝
Windows 系統:choco install pandocmacOS 系統:brew install pandocVScode 同樣很強大在官網[24]下載安裝 VScode,進入初始界面。默認語言是英文,需要的話,可以安裝中文漢化擴展。
即使 VScode 原生支持 Markdown,但是想要獲得更地道的體驗,還是得安裝幾個擴展:
Markdown Preview Enhanced[25]以上這兩個擴展基本支持了 Markdown 所需的各種操作,例如實時預覽、快捷鍵、生成 TOC 和導出文件等。
當然,Markdown 也有缺點,比如對圖片和表格等很不友好,下篇文章我會 重點介紹如何「圖床與Markdown」。希望這幾篇文章對你做個人筆記有所幫助,歡迎點擊下方圖片給我留言,我們一同進步~~Reference[1]Markdown 中文文檔: https://markdown-zh.readthedocs.io/en/latest/
[2]Markdown 指南中文版: https://www.markdown.xyz/
[3]Markdown 菜鳥教程: https://www.runoob.com/markdown/md-tutorial.html
[4]Emoji-Cheat-Sheet: https://www.webfx.com/tools/emoji-cheat-sheet/
[5]Markdown 書寫風格指南: http://einverne.github.io/markdown-style-guide/zh.html
[6]少數派寫作排版指南: https://sspai.com/post/37815
[7]中文文案排版指北: https://github.com/mzlogin/chinese-copywriting-guidelines
[8]馬克飛象: https://maxiang.io/
[9]StackEdit: https://stackedit.io/
[10]Editor: https://pandao.github.io/editor.md/
[11]Cmd Markdown: https://www.zybuluo.com/mdeditor
[12]MdEditor: http://www.mdeditor.com/
[13]Arya: https://markdown.lovejade.cn/
[14]Typora: https://ulysses.app/
[15]VScode: https://code.visualstudio.com/
[16]Ulysses: https://ulysses.app/
[17]Bear: https://bear.app/
[18]MWeb: https://www.mweb.im/
[19]Typora: https://typora.io/
[20]下載地址: https://typora.io/#download
[21]官網主題商店: https://theme.typora.io/
[22]Pandoc: https://pandoc.org/
[23]官網: https://pandoc.org/installing.html
[24]官網: https://code.visualstudio.com/
[25]Markdown Preview Enhanced: https://shd101wyy.github.io/markdown-preview-enhanced/#/
[26]Markdown All in One: https://marketplace.visualstudio.com/items?itemName=yzhang.markdown-all-in-one
[27]免費開源的在線 Markdown 編輯器: https://linux.cn/article-12624-1.html