《了不起的Markdown》第六章

第六章 Markdown工具一籮筐

6.1 記筆記

??筆記軟件主要是用來幫助用戶記錄重要信息、事件及想法的。在筆記軟件中使用Markdown寫作的優(yōu)點顯而易見——除了能夠使用筆記軟件自身的所有功能,還能享受Markdown專注而高效的寫作特點。目前市場上比較流行的筆記軟件主要有印象筆記、有道云筆記和OneNote等。

6.1.1 印象筆記

??印象筆記也支持Markdown了,它支持基礎(chǔ)Markdown語法和GFM語法,并且跟有道筆記一樣,能夠通過使用模板快速繪制數(shù)學(xué)公式、流程圖、時序圖、甘特圖,令人驚喜的是,印象筆記還提供了快速繪制多種圖表的功能。
??總之,一句話,在印象筆記中使用Markdown寫作,讓人有一種愉悅的感覺,從功能到配色,到處透露著“高級感”。
??在印象筆記的左上角單擊【新建Markdown筆記】可以新建Markdown筆記,也可以使用快捷鍵新建。

macOS系統(tǒng) Windows系統(tǒng)
Command + D Ctrl + D

??默認(rèn)使用的是經(jīng)典的Markdown編輯模式,左邊是源碼,右邊是預(yù)覽。通過工具欄上的【切換編輯模式】按鈕能夠在純編輯模式和經(jīng)典模式之間切換,通過右上角的【Markdown預(yù)覽】按鈕能夠進(jìn)入純預(yù)覽界面。
??在印象筆記的工具欄上,提供了常用標(biāo)記的快速插入功能,包括一些常用的圖表模板,把鼠標(biāo)放到圖標(biāo)上,會顯示圖標(biāo)的功能提示。

  • 使用印象筆記中的Markdown添加流程圖和圖表的便捷之處:
  1. 添加流程圖
    在單擊工具欄上的【添加流程圖】之后,會在源碼編輯器中插入流程圖的代碼模板,我們只需要根據(jù)這個模板進(jìn)行修改就可以了,不必再從頭寫起(何況語法并不容易記?。?。

  2. 添加圖表
    印象筆記支持在Markdown中添加4種圖表——餅圖、折線圖、柱狀圖、條形圖,不同圖表之間可以通過改變源碼中type的值進(jìn)行切換,可選值為pie、line、column、bar。令人驚喜的是,這些圖表在預(yù)覽界面都是可以進(jìn)行交互操作的。

  3. 添加圖片
    在印象筆記中可以通過工具欄上的【插入圖片】上傳本地的圖片,也可以直接拖拽添加,或者從剪切板中粘貼,而這些功能在有道云筆記中只有會員才可以使用。
    另外,我們還可以非常方便地設(shè)置圖片大?。?/p>

    1. 本地圖片/網(wǎng)絡(luò)圖片@w=100。
    2. 本地圖片/網(wǎng)絡(luò)圖片@h=100。
    3. 本地圖片/網(wǎng)絡(luò)圖片@w=100h=100。
  4. 文件轉(zhuǎn)換
    在編輯界面或源碼界面上,單擊鼠標(biāo)右鍵,可以導(dǎo)出Markdown格式的筆記,也可以將筆記轉(zhuǎn)換為PDF格式的文件。

??通過印象筆記轉(zhuǎn)換的PDF文件非常漂亮,它基本保持了Markdown預(yù)覽時的效果。另外,我們還可以在印象筆記中對PDF文件進(jìn)行標(biāo)注、預(yù)覽和下載。

6.1.2 有道云筆記

??有道云筆記應(yīng)該是國內(nèi)使用用戶最多的筆記軟件了,它功能全、速度快,而且免費(針對大部分功能)。它對Markdown的支持也比較全面,支持在電腦端、手機(jī)端、Web端等多平臺使用Markdown,除支持基礎(chǔ)的Markdown語法外,有道云筆記還支持代碼高亮、任務(wù)列表、表格、數(shù)學(xué)公式,能夠高效繪制流程圖、序列圖、甘特圖。
??在電腦端和Web端,都是通過在文件夾處單擊鼠標(biāo)右鍵→【新文檔】→【新建Markdown】來新建Markdown文件的。
??在手機(jī)端,則通過單擊【+】按鈕,選擇【Markdown】來新建筆記。
??創(chuàng)建Markdown文件之后,就進(jìn)入我們熟悉的Markdown編輯環(huán)境了,相信你已經(jīng)對Markdown語法駕輕就熟了。如果懶得去記這些語法,在工具欄上提供有一排快速插入語法的圖標(biāo),一目了然。
??值得注意的是,PC端的有道云筆記提供了快速插入公式和圖表的模板,我們只需要根據(jù)模板進(jìn)行修改就可以得到自己想要的圖表了,

小提示

  1. 在有道云筆記中,只有會員才能在Markdown中直接上傳本地圖片,這一點很不方便,而印象筆記沒有這個限制。
  2. 在有道云筆記中,Markdown預(yù)覽界面可以直接進(jìn)行演示,但在印象筆記中必須是會員才可以。

6.1.3 OneNote

??OneNote本身并不直接支持Markdown,但如果想在OneNote中使用Markdown,可以通過插件來實現(xiàn)。
??插件下載地址:https://www.onenotegem.com/one-markdown.html,目前只支持Windows版本。

6.2 在線多人協(xié)作工具

??在線文檔可以讓我們隨時隨地創(chuàng)建、編輯、與他人協(xié)作處理文檔,是協(xié)同辦公必備的工具。目前比較流行的兩個在線協(xié)作工具是騰訊文檔和石墨文檔,它們都支持一些簡單的Markdown語法。在使用時你可能找不到切換Markdown的入口,這是因為根本沒有入口,直接通過“標(biāo)記符號+空格”使用就好了,效果是實時渲染的。

6.2.1 騰訊文檔

??騰訊文檔支持的Markdown語法有標(biāo)題(6級)、分隔線、有序列表和無序列表。

6.2.2 石墨文檔

石墨文檔支持的Markdown語法:

  1. 標(biāo)題(3級)。
  2. 有序列表。
  3. 無序列表。
  4. 任務(wù)列表([]+空格)。
  5. 代碼塊(行首輸入```+空格)。

??除在編輯時可以使用上述簡單的Markdown語法外,石墨文檔還支持導(dǎo)入/導(dǎo)出Markdown文件,能正常解析幾乎所有GFM語法。

6.3 寫博客

6.3.1 知乎

??知乎并沒有專門的Markdown編輯器,但在發(fā)布文章或回答問題時,可以使用粗體、斜體、代碼塊、引用、標(biāo)題、有序列表、無序列表、分隔線等Markdown標(biāo)記來對文字進(jìn)行快速排版,使用方法是“標(biāo)記符號+空格”,代碼塊是“```+回車鍵”。
??除此之外,還可以通過【文檔導(dǎo)入】功能,將Markdown文件導(dǎo)入知乎。不過需要注意的是,基礎(chǔ)的Markdown語法能被正常解析,但一些擴(kuò)展語法,如表格、任務(wù)列表、刪除線等就無法被解析了,它們將以純文本的形式顯示。

小提示: 【文檔導(dǎo)入】圖標(biāo)在工具欄的最右邊,單擊【…】才能看到。

6.3.2 簡書

??簡書作為一款被廣泛使用的寫作工具,也支持基礎(chǔ)的Markdown語法,在其新建文章界面,通過【設(shè)置】→【默認(rèn)編輯器】可以切換為Markdown編輯器。

6.3.3 CSDN

??寫技術(shù)博客的人應(yīng)該都聽說過CSDN,它的Markdown編輯器功能已經(jīng)非常全面,使用Typora編寫的Markdown源碼(包括表格、公式、流程圖、甘特圖等),粘貼或?qū)氲紺SDN基本上都可以正常顯示。
??在【創(chuàng)作中心】可以切換Markdown編輯器和富文本編輯器,在Markdown編輯器中可以直接編寫、粘貼或?qū)隡arkdown文件,可以將圖片拖拽上傳,這些都大大提高了博客的寫作效率。

6.4 寫微信公眾號文章

??“再小的個體,也要有自己的品牌”,很多公司、團(tuán)隊和個人都有自己的微信公眾號。寫過微信公眾號文章的朋友可能都遇到過排版問題,使用Markdown雖然方便,但很多格式在微信公眾號編輯器中不支持,有些格式支持得也不是很好。
??這里推薦兩款在線格式化工具來幫助解決上述排版問題,它們可以將Markdown文檔直接渲染成適合微信公眾號的格式,并且有多種主題可以選擇。

6.4.1 Online-Markdown

??打開https://www.flyzy2005.cn/tools/online-markdown/進(jìn)入在線編輯頁面,可以根據(jù)個人喜好調(diào)整頁面主題和代碼主題,還可以實時預(yù)覽渲染效果,復(fù)制渲染后的內(nèi)容,粘貼到微信公眾號的編輯器中,原有的文檔格式會得以保持。

6.4.2 Md2All

??Md2All的使用方法跟Online-Markdown差不多,只不過多了一個下載HTML文檔的功能。Md2All地址為http://md.aclickall.com/。

6.5 寫郵件——Markdown Here

??寫郵件是日常工作中最常見的寫作場景之一,幾乎人人都要寫郵件。通常使用Markdown寫郵件的步驟是:在Markdown編輯器中寫郵件→復(fù)制渲染后的內(nèi)容→粘貼到郵件編輯器→發(fā)送郵件。這種方法本身沒什么問題,但是操作步驟復(fù)雜,一旦郵件內(nèi)容有修改還得照上面的步驟再操作一次,實在太麻煩。
??Markdown Here幫我們解決了這個問題。它不但能讓我們在郵箱中直接使用Markdown寫郵件,還可以通過配置樣式讓郵件內(nèi)容變得更加美觀。
??Markdown Here是一個瀏覽器/客戶端插件,它支持GFM語法,可以一鍵渲染富文本編輯器中的Markdown語法,這讓我們可以使用任意Web編輯器來寫郵件。
??Markdown Here提供了適用于Chrome、Firefox、Safari、Opera瀏覽器的插件和Thunderbird、Postbox郵件客戶端插件。下載地址:https://markdown-here.com/get.html。源碼地址:https://github.com/adam-p/markdown-here/。

6.5.1 安裝Chrome插件

??在Chrome應(yīng)用商店中,搜索“Markdown Here”,找到后進(jìn)入安裝界面,單擊右上角的【+添加至CHROME】安裝插件,安裝成功后重啟Chrome,在右上角會顯示Markdown Here圖標(biāo)。

6.5.2 使用Markdown寫郵件

??理論上,Markdown Here可以渲染所有Web端富文本編輯器中的Markdown文檔,本例就以最常用的163郵箱為例,看看如何使用Markdown來寫郵件。

  1. 使用Chrome打開163郵箱,在文本編輯器中使用Markdown編寫郵件
  2. 把光標(biāo)放在編輯器中,單擊Chrome上的Markdown Here圖標(biāo),渲染編輯器中的內(nèi)容
  3. 發(fā)送郵件

??只需要單擊瀏覽器上的Markdown Here圖標(biāo),就可以把編輯器中的Markdown渲染成HTML格式的文檔,再次單擊該圖標(biāo)就可以切換回Markdown格式,神奇的Markdown Here把所有的Web編輯器都變成了Markdown編輯器。

6.5.3 自定義主題

??如果你不喜歡Markdown Here的默認(rèn)主題,也可以自定義主題。在Chrome瀏覽器的Markdown Here圖標(biāo)上,單擊鼠標(biāo)右鍵,在彈出的操作列表中單擊【選項】進(jìn)入設(shè)置界面。在【基本渲染CSS】中可以自定義Markdown主題,在【語法高亮CSS】中可以選擇代碼高亮的主題,在【預(yù)覽】中可以實時查看效果。

把主題改為一款比較流行的主題——markdown-here-css,操作步驟:

  1. 打開https://github.com/caseywatts/markdown-here-css。
  2. 再打開項目列表中的default.css文件。
  3. 復(fù)制文件中的所有內(nèi)容。
  4. 粘貼到【基本渲染CSS】中(Markdown Here會自動保存)。
  5. 在預(yù)覽中查看新主題的效果。

??如果你是一名前端開發(fā)者,可以嘗試定制一款屬于自己的主題。而對于普通用戶來說,使用現(xiàn)成的主題就好了。
??下面這個項目中收集了一些Markdown Here的主題,大家可以去嘗試一下:https://github.com/huanxi007/markdown-here-css

小提示: 如果配置主題時出錯了,也不用緊張,【基本渲染CSS】下面有一個【恢復(fù)默認(rèn)】按鈕,一鍵恢復(fù)即可。

6.5.4 快捷鍵

??在Markdown編輯界面和渲染效果界面之間切換,除通過單擊Markdown Here圖標(biāo)之外,還可以使用快捷鍵。

macOS系統(tǒng) Windows系統(tǒng)
Control + Option + M Ctrl + Alt + M

??如果快捷鍵沖突,可以修改快捷鍵,方法同樣是進(jìn)入設(shè)置界面,找到【快捷鍵】一欄,對快捷鍵的設(shè)置及其注意事項,一目了然。更多有關(guān)Markdown Here的使用技巧,可以參考https://github.com/adam-p/markdown-here/wiki/Tips-and-Tricks。

6.6 其他常見的Markdown工具

6.6.1 便簽工具——錘子便簽

??錘子便簽算是手機(jī)上比較有名的便簽工具了,它支持簡單的Markdown語法,主要應(yīng)用在文字的排版上。
??在使用時,通過右上角的下拉列表,切換至【Markdown模式】即可;在編輯時,輸入法上方會顯示一排快速輸入工具。
??當(dāng)使用圖片形式分享時,Markdown格式的內(nèi)容會被渲染,而以文字形式分享或發(fā)送郵件發(fā)送的都是源碼。

6.6.2 日記軟件——DayOne

?? DayOne 應(yīng)該是在 Mac 和 iOS 設(shè)備上最受歡迎也最好用的日記軟件了。它能夠在新建日記時自動記錄各種比較隱私的信息,如時間、位置、天氣等,然后可以通過這些信息或自定義的標(biāo)簽篩選過往的日記。另外DayOne還支持使用Markdown對日記進(jìn)行排版,使用方法與在線文檔相同,通過“標(biāo)記符號+空格”插入和渲染Markdown格式。
??DayOne支持的Markdown格式主要有標(biāo)題、加粗、斜體、有序列表、無序列表、任務(wù)列表( [ ] +空格)、引用、代碼塊(行首輸入 ``` + 空格)和分隔線等,其效果如下圖所示。

6.6.3 交互式文檔工具

??相較于普通的文檔,交互式文檔最大的不同就是,文檔中的代碼是可執(zhí)行的。普通文檔插入代碼后,代碼是“死”的,但交互式文檔會執(zhí)行代碼,并顯示代碼的執(zhí)行結(jié)果。
??想像一下,當(dāng)你在學(xué)習(xí)一門編程語言或?qū)懠夹g(shù)文章時,只要在文檔中輸入代碼,結(jié)果就會直接顯示出來,如果代碼有變動,結(jié)果也會隨即改變,這樣一來,就再也不用在IDE和文檔之間來回切換,復(fù)制/粘貼了。
??交互式文檔應(yīng)用最廣泛的領(lǐng)域是技術(shù)寫作、數(shù)據(jù)分析和機(jī)器學(xué)習(xí),目前最流行的兩個工具是 Jupyter Notebook 和 R Markdown。

1.Jupyter Notebook

??Jupyter Notebook 是一個 Web 交互式文檔工具,它使用 Markdown 編寫文本,有著類似于 Typora 的所見即所得的功能,不過它的所見即所得還包括代碼的即時運行。Jupyter Notebook可以在文檔中直接編寫和運行代碼(支持40多種編程語言),并即時顯示運行結(jié)果,是集寫作、編程及運行于一體的交互式文檔工具。
??從名字上看Jupyter是Julia、Python和R的組合,這3種語言是數(shù)據(jù)分析和機(jī)器學(xué)習(xí)領(lǐng)域非常重要的編程語言,那么,Jupyter的意義也就不言而喻了。由于能完整地展現(xiàn)文本、公式、代碼及代碼運行的整個過程,目前Jupyter Notebook已經(jīng)成為技術(shù)寫作、數(shù)據(jù)分析和機(jī)器學(xué)習(xí)方面必備的編輯工具。

a. 安裝和啟動

??Jupyter Notebook的安裝方法可訪問:https://jupyter.readthedocs.io/en/latest/install.html。頁面上方為Jupyter Notebook的簡要說明,下方為安裝及環(huán)境要求。
??在終端啟動Jupyter Notebook的命令是jupyter notebook。然后瀏覽器會自動打開http://localhost:8888/tree,如果沒有自動打開,請自已輸入該網(wǎng)頁地址。

小提示: 默認(rèn)端口是8888,如果要指定端口,需要加上-port,例如jupyter notebook-port=6666。

b. 創(chuàng)建文檔

??在Jupyter Notebook首頁上單擊右上角的【New】→【Python 3】→進(jìn)入文檔編輯界面(內(nèi)核是Python 3),如下圖所示。
??小提示: Jupyter Notebook默認(rèn)只安裝了Python 3的內(nèi)核,如果想要安裝其他內(nèi)核請參考https://github.com/jupyter/jupyter/wiki/Jupyter-kernels。

c. 單元類型

??Jupyter Notebook文檔是由一系列“單元”組成的,這些“單元”主要分為兩類——Markdown文本和代碼。它們都可以通過Shift+Enter組合鍵進(jìn)行渲染和執(zhí)行,Markdown單元會直接顯示渲染后的效果,代碼單元會在其下面顯示執(zhí)行后的結(jié)果。單元的默認(rèn)格式是代碼(Code),可以通過工具欄進(jìn)行切換。
??在Markdown單元中使用Markdown標(biāo)記來格式化文本,支持GFM語法,可直接顯示渲染效果。代碼單元用于編寫代碼(要與內(nèi)核相匹配),支持代碼高亮,可直接顯示運行結(jié)果。

d. 導(dǎo)出文檔

??Jupyter Notebook可通過【菜單欄】→【File】→【Download as】導(dǎo)出HTML、Markdown、PDF、reveal.js幻燈片、reStructuredText、LA TEX等多種格式的文檔。

e. 更多內(nèi)容

更多關(guān)于Jupyter Notebook的內(nèi)容請參考其開源地址:https://github.com/jupyter/notebook和官方文檔https://jupyter-notebook.readthedocs.io/en/stable/

2. R Markdown

??R Markdown,顧名思義就是在Markdown中通過R語言實現(xiàn)交互式文檔(現(xiàn)在也支持Python、Bash、SQL等常用語言),在數(shù)據(jù)分析領(lǐng)域有著舉足輕重的地位。

a. 創(chuàng)建文檔

??使用R Markdown前需要先安裝R語言和RStudio編輯器,然后在RStudio中通過【菜單欄】→【File】→【New】→【R Markdown...】來新建文檔(如果是首次使用會先安裝rmarkdown包),然后會彈出R Markdown類型選擇窗口。

  • 文檔類型
  1. Document:普通文檔,可創(chuàng)建HTML、PDF和Word格式的文檔,推薦選擇HTML格式,因為HTML格式的文檔可以隨時切換成PDF文檔或Word文檔。
  2. Presentation:幻燈片,可創(chuàng)建HTML和PDF格式的幻燈片。
  3. Shiny:交互式文檔,可創(chuàng)建交互式文檔和交互式幻燈片。
  4. From Template:通過模板創(chuàng)建文檔。
b. 導(dǎo)出文檔

??單擊【Knit】會渲染Markdown文本并執(zhí)行文檔中所有的R代碼,并把結(jié)果追加到代碼之后,然后導(dǎo)出HTML(因為我們之前選擇的是HTML)文檔。
??HTML格式的文檔可以隨時切換成PDF文檔或Word文檔,可以通過【Knit】右邊的下拉菜單進(jìn)行切換

小提示: 如果要導(dǎo)出PDF或Word格式的文檔需要安裝對應(yīng)的工具,在新建R Markdown時或?qū)С鰣箦e時會有相關(guān)的提示。

c. 插入代碼

??在R Markdown中,可以通過工具欄上的【Inset】插入代碼塊,目前支持的語言有R、Bash、Python、Rcpp、SQL、Stan。

summary(cars)

??在默認(rèn)情況下,文檔中的代碼是未執(zhí)行的,我們可以選擇執(zhí)行一個代碼塊或所有代碼,執(zhí)行代碼的所有操作可以通過工具欄上【Run】的下拉列表查看。

d. 更多內(nèi)容

??更多關(guān)于R Markdown的內(nèi)容請參考官方文檔https://rmarkdown.rstudio.com/或R Markdown權(quán)威指南https://bookdown.org/yihui/rmarkdown

6.6.4 網(wǎng)頁編寫工具——md-page

??Markdown文檔是可以通過工具轉(zhuǎn)換成HTML文檔的,不過這里要經(jīng)歷一次轉(zhuǎn)換,以后若有修改,還得再次進(jìn)行轉(zhuǎn)換。能否直接使用Markdown來編寫網(wǎng)頁,而不需要轉(zhuǎn)換呢?可以使用md-page這個項目。
??項目地址:https://github.com/oscarmorrison/md-page。
??在添加md-page.js這個依賴以后,就可以直接使用Markdown來寫一些簡單的網(wǎng)頁了,無須轉(zhuǎn)換格式,直接雙擊文檔即可瀏覽。

  • 具體步驟
  1. 使用任意編輯器(推薦VS Code)新建一個HTML文件,如my.html。

  2. 在my.html的頂部添加所依賴的JS腳本。

    <script src="https://rawcdn.githack.com/oscarmorrison/md-page/master/md-page.js">
    </script>
    

    注意: 由于網(wǎng)絡(luò)原因,這個腳本加載起來可能會比較慢,從而嚴(yán)重影響渲染效果。建議從md-page項目中下載md-page.js到本地,并與my.html放在同一個目錄中。

    <script src="./md-page.js">
    </script><npscript>
    
  3. 使用Markdown編寫頁面內(nèi)容。
    現(xiàn)在,就可以使用最熟悉的Markdown來編寫頁面內(nèi)容了,編寫完成后雙擊my.html即可查看頁面效果。

6.6.5 項目文檔寫作工具

1. MkDocs

??MkDocs是一款用Python開發(fā)的靜態(tài)站點生成器,它可以快速地創(chuàng)建項目文檔。文檔的源碼使用Markdown編寫,配置文件使用YAML編寫,能夠一鍵編譯成靜態(tài)站點,使用起來非常方便。
??由于很多開源的項目文檔都使用MkDocs編寫,如Google的python-fire,因此有必要學(xué)習(xí)一下。

a. 環(huán)境配置
  • 安裝MkDocs
pip install mkdocs
  • 查看MkDocs版本
mkdocs -V
b. 創(chuàng)建項目
# 第一步
mkdocs new project_name
# 第二步
cd project_name
# 第三部
tree
c. 啟動服務(wù)

??啟動服務(wù)的命令是 mkdocs serve,然后,在瀏覽器中打開http://127.0.0.1:8000。在服務(wù)器啟動后,如果配置文件、文檔目錄或主題發(fā)生改變,則服務(wù)器會自動加載變更的結(jié)果并生成新的文檔。

d. 添加頁面

??在MkDocs中,一個Markdown文件被渲染后就是一個頁面,因此如果我們想添加頁面,就需要先在docs目錄下添加一個Markdown文件,文件的后綴名可以是md(推薦)、markdown、mdown、mkdn或mkd。

  • 添加頁面的實例演示
  1. 在docs目錄下添加幾個Markdown文件
    說明: 文件夾docs的目錄結(jié)構(gòu)對應(yīng)著生成頁面的URL路徑,

  2. 修改配置文件mkdocs.yml

site_name: Grade markdown 
pages:
- 首頁: index.md
- 語法: grammer.md
- 規(guī)范: standard.md
- Typora: typora.md
- VS Code: vscode.md
- 個人簡歷: resume.md
  1. site_name是站點的名稱。
  2. 在pages中配置的是導(dǎo)航欄上的頁面名稱,每一個頁面對應(yīng)一個Markdown文件。
e. 配置主題

??MkDocs的主題是可以配置的,默認(rèn)主題是mkdocs。如果想切換成別的主題,只要修改theme的值就可以了。

site_name: Grade markdown 
pages:
- 首頁: index.md
- 語法: grammer.md
- 規(guī)范: standard.md
- Typora: typora.md
- VS Code: vscode.md
- 個人簡歷: resume.md

theme: mkdocs

??主題分為內(nèi)置主題、第三方主題和自定義主題,內(nèi)置主題如上所述,直接配置主題名就可以了。如果是第三方主題,就需要先安裝主題再進(jìn)行配置了,自定義主題需要增添插件、后續(xù)操作也稍顯復(fù)雜,但使用效果并不明顯。

f. 生成站點

??如果想發(fā)布項目,需要先構(gòu)建項目,生成一個靜態(tài)資源站點,構(gòu)建項目的命令mkdocs bulid。更多內(nèi)容請參考https://www.mkdocs.org/

2.VuePress

??VuePress是一個比較新的靜態(tài)網(wǎng)站生成器,主要用于編寫技術(shù)文檔。它集各家之所長,提供了在Markdown文件中使用Vue組件的功能,集成了Google Analytics,以及基于Git的“最后更新時間”功能。
??VuePress有完整的中文指南,網(wǎng)址為:https://vuepress.vuejs.org/zh/guide/

6.6.6 付費軟件

??如果不考慮手機(jī)端寫作,Typora和VS Code這兩款免費軟件完全可以滿足我們的需求(多設(shè)備同步通過Git實現(xiàn)),不過一些付費軟件提供了更專業(yè)的服務(wù)、更低的使用門檻、更好的用戶體驗,以及更多的寫作平臺。

1. 常見付費軟件

軟件 Markdown 適用平臺 價格 適用人群
Ulysses Markdown XL macOS、iPad、iPhone 28元/月或218元/年 頻繁進(jìn)行文字寫作的人
MWeb GFM macOS、iPad、iPhone 218元 技術(shù)寫作人員
MarkdownPad GFM Windows 14.95美元 Windows用戶
CMD Markdown GFM Web、Linux、macOS、Windows 99元/年 熱愛Markdown的人

??目前付費的Markdown軟件中最有名的應(yīng)該是Ulysses、MWeb和Bear(熊掌記)了,它們都是蘋果體系產(chǎn)品,都支持Mac、iPad、iPhone設(shè)備。
??其中最強(qiáng)大也最貴的當(dāng)屬Ulysses,它比較適合頻繁進(jìn)行文字寫作的人,基本上可以滿足寫作者的一切需求,但是它的Markdown XL語法可能會讓你覺得不習(xí)慣,也不太通用。
??最符合國人寫作習(xí)慣的是MWeb,它所支持的語法也是最全面的,例如表格和流程圖(Ulysses和Bear都不支持),適合寫技術(shù)文章比較多的人。
??最年輕、最簡潔、最好看,也是性價比最高的當(dāng)屬Bear,它在風(fēng)格上像年輕版的Ulysses,在電腦和手機(jī)端都有非常好的用戶體驗。這里要重點推薦Bear。

2.Bear

??Bear(熊掌記)是一款非常流行的Markown筆記軟件,由于極簡的設(shè)計風(fēng)格和友好的交互界面,Bear能夠讓用戶快速上手,然后又愛不釋手。
??使用Bear寫筆記,最直觀的感受就是舒服。它很好地將Markdown和寫筆記的需求進(jìn)行了融合,巧妙地使用標(biāo)簽管理筆記,連新建文件夾都省了;它還提供了Safari、Chrome、Firefox和Opera瀏覽器的擴(kuò)展插件,能夠“一鍵下載文章”,該插件地址為:https://bear.app/faq/Extensions/Browserextensions/。
??Bear基礎(chǔ)版可單點使用,支持Mac、iPad、iPhone設(shè)備;若想多設(shè)備同步,則需要使用付費的高級版本 。
??如果用過Typora,應(yīng)該會覺得Bear很親切,它們的界面風(fēng)格有點像。不過Bear在支持Markdown實時渲染的同時,又保留了標(biāo)記符號,這樣比較方便查看和修改,在這一點上,如果你習(xí)慣了Typora,可能會覺得有點別扭。

  • 關(guān)于Bear需要知道如下幾點
  1. Bear支持“文件”(插入文件)和“標(biāo)記”(高亮選中的內(nèi)容)語法,雖然它們在Bear中用起來很方便,但在其他Markdown工具中這兩個功能并不常見,所以使用時要考慮其兼容性。
  2. 不支持表格、目錄、流程圖、甘特圖、數(shù)學(xué)公式及各種圖表。
  3. 不支持大綱視圖,如果文章比較長,查看會不太方便。
  4. 可直接在Bear中粘貼剪切版中的圖片。
  5. 若有未執(zhí)行完的待辦事項,會在左邊導(dǎo)航欄的【待辦事項】中顯示,在筆記的標(biāo)題上會顯示“待辦事項”的整體進(jìn)度。
  6. 使用兩個方括號包裹筆記名是可以鏈接筆記的,例如[ [ 筆記名 ] ],在輸入 [[ + 空格之后,Bear會給出補(bǔ)全信息。
a. 標(biāo)記符號

??Bear簡單化了“文本格式”的標(biāo)記符號,但同時也提供了標(biāo)準(zhǔn)格式的兼容模式,可以到偏好設(shè)置中開啟【兼容Markdown兼容模式】。

b. 調(diào)整排版樣式

??在排版方面,Bear可以在偏好設(shè)置中調(diào)節(jié)字體大小、行高、行寬和段落間距。

c. 使用標(biāo)簽整理筆記

??在Bear中,可以使用標(biāo)簽歸類整理筆記。標(biāo)簽可以放置在筆記中的任何地方,只需要使用#號包裹起來即可,Bear還會自動識別常見標(biāo)簽并添加相應(yīng)的圖標(biāo)。

d. 手機(jī)端寫作

??使用Bear在手機(jī)端寫作與在電腦上寫作有同樣好的體驗。

6.7 本章小結(jié)

??本文介紹了很多專業(yè)的Markdown工具,以幫助讀者更好地應(yīng)對日常寫作,了解了這些,在什么樣的場景使用什么樣的工具,相信已經(jīng)胸有成竹了。

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時請結(jié)合常識與多方信息審慎甄別。
平臺聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點,簡書系信息發(fā)布平臺,僅提供信息存儲服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容