無門檻學習程式設計師文件神器:Markdown

有一種文件格式叫Markdown,有一種情懷叫簡單就是美!

無門檻學習程式設計師文件神器:Markdown

Markdown是什麼東東,為什麼要用?

它是一種文件格式(也叫md),大家可能用過或見過“。doc”、“。docx”、“。htm”等不同字尾名的檔案,代表了Word或者網頁檔案,這些檔案已經非常成熟和通用了,為什麼還要用Markdowd呢(檔案字尾為。md或者。markdown)?它的優點如下,看看有沒有get到你。

專注於你的文字內容而不是排版樣式,安心寫作(內容為王)

直觀、易於閱讀、學習成本低(看完本文件就差不多了_)

可以匯出HTML、PDF、PNG等

純文字內容,相容所有的文字編輯器與字處理軟體

據說很多國內外網路小說作家以及文學創作者都在開始使用Markdown了。

用什麼工具寫Markdown?

編寫Markdown文件,可以直接線上進行,比如CSDN提供的線上Markdown編輯器( https://editor。csdn。net/md/)(彆著急點,可以看完本文後再過去:) )。也可以下載一個本地工具,不依賴於網路環境也能夠進行碼字碼程式碼,本文推薦VSCode(免費、流行、好用)。

接下來結合VSCode工具(編寫文件的地方)和Markdown語法(格式約定)一起學習使用md!

下載安裝VSCode

官網下載地址:單擊此處下載

無門檻學習程式設計師文件神器:Markdown

選擇匹配的作業系統版本進行下載。下載後安裝過程比較簡單,一路“下一步”直到“完成”即可。

進行漢化[非必選項]

開啟VSCode,使用快捷鍵Ctrl+Shift+P,在出現的輸入框中輸入configure display language,回車確認,在出現的輸入框下選擇Install additional languages,en代表英文。

在主介面的擴充套件外掛中點選“Chinese (Simplified) Language Pack for Visual Studio Code”點選“Install”重啟即可。

安裝PDF外掛[非必選項,圖個方便]

安裝PDF外掛可以將Markdwon檔案匯出為PDF、圖片等格式。編輯好的內容面向“普通”使用者,還是需要“包裝”一下(md深藏功與名)。

在擴充套件外掛中輸入“Markdown PDF”,選擇安裝即可。

無門檻學習程式設計師文件神器:Markdown

至此,萬事俱備只欠東風,可以開始在VSCode中編寫Markdown文件了。

簡潔的語法,不簡單的效果

寫一個文件,主要結構無非是:“標題”,“正文”、“列表”、“圖片”。除了這幾個元素,可能部分文字需要修飾一下,比如“

加粗

”、“

斜體

”。

超連結

也是網際網路傳播不可或缺的元素。除了這些,Markdown還提供插入“

程式碼

”、“

引用

”和“

分割線

”等。當然你想要在文件中插入一個“

表格

”也是可行的。嗯,差不多了,這些夠我們現在學一壺了

接下來,在VSCode中我們來一一嘗試吧。

VSCode建立一個md檔案

在VSCode中建立一個檔案,儲存檔案時副檔名(字尾名)為“。md”,這樣VSCode,就可以識別,並按照Markdown的語法進行解析。

無門檻學習程式設計師文件神器:Markdown

建立md檔案後在側邊上欄會有一個按鈕(開啟側邊預覽),單擊後我們就可以以一遍寫md文件,一遍即時檢視文件效果。

無門檻學習程式設計師文件神器:Markdown

我們可以開始愉快地編寫md文件了。

無門檻學習程式設計師文件神器:Markdown

md:標題

標題可以分為六級,從一級到六級。一個井號(#)代表一級,如下圖所示(注意多個井號之間不要有空格,寫完井號,至少要有一個空格,然後開始寫標題)。

無門檻學習程式設計師文件神器:Markdown

一般來講,一個文件有六個級別的標題是夠用了,每個標題都獨立佔據一行。在上面的圖片中測試了沒有使用標題標記與使用標題標記的區別。

md:正文

關於正文就比較簡單了,直接開啟你的天賦技能:寫寫寫、敲敲敲即可(風聲雨聲鍵盤聲,聲聲入耳~ )。

md文件中編寫正文的測試如下圖所示,注意段落間換行。不用把注意放在空格、對齊等無關內容的事項上,把你的文思泉湧展現出來就可以了。

無門檻學習程式設計師文件神器:Markdown

md:列表

列表分為有序列表和無序列表。這也是撰寫文件時經常使用到的點。

無門檻學習程式設計師文件神器:Markdown

列表巢狀的時候,下一級可以用鍵盤上的“Tab”鍵進行縮排,其他不用太糾結。

md:圖片

顯示圖片首先要考慮路徑的問題,為了方便演示,此處用一個網際網路上的圖片做演示(如果是計算機本地圖片最好使用相對路徑)。路徑的核心是:你的md文件能夠時刻找到你的圖片,md文件中的圖片僅僅是一個引用而已。

無門檻學習程式設計師文件神器:Markdown

![

圖片名

](

圖片地址

顯示圖片需要用到的三種符號:

感嘆號“!”是必須的;中括號“[]”中間可以寫圖片名稱,如果圖片不能正確顯示,會顯示名稱;小括號“()”中間寫圖片正確路徑,路徑後用空格隔開連結一個雙引號可以寫一個圖片提示文字,這樣滑鼠懸停到圖片上會有提示文字出現,如上圖所示,這個提示文字不是必選項。

注意:符號都需要在英文輸入狀態下錄入。

md文件主要以文字為主,對圖片僅僅是一個引用,如果你想調整圖片大小、居中…這個就沒有必要了,圖片不宜過多(嗯,雖然本文圖片不少~)。

md:超連結

超連結的用法與圖片非常相似,沒有了圖片的感嘆號“!”,中括號中寫超連結顯示內容,小括號中寫實際的連結地址。

顯示文字

](

超連結地址

)示例:[

C站能力認證中心

](

https://ac。csdn。net/

md:一些特殊格式

#

# 特殊格式

#

## 加粗

床前 **明月** 光​#

## 斜體

​床前 *明月* 光​#

## 刪除線

​床前 ~~明月~~ 光​#

## 分割線

​三個連續星號​***​三個連續減號​——-​三個連續下劃線​___​#

## 轉意

​\\​\*​\-​​

無門檻學習程式設計師文件神器:Markdown

==強調文字用雙等號包裹起來,效果如下==

強調文字

H~2~O 下標效果如下

H2O

2^10^ = 1024 上標效果如下

210 = 1024

md:程式碼和引用

程式碼

單行程式碼引用,用`號包裹起來就可以(是鍵盤上1前面的那個符號,不是單引號)

示例:

print ‘Hello !’

詳見下面圖片。

無門檻學習程式設計師文件神器:Markdown

可以在程式碼塊明確部分語言,實現部分程式碼高亮樣式

無門檻學習程式設計師文件神器:Markdown

引用

用>符號可以當做引用示意,如下。

無門檻學習程式設計師文件神器:Markdown

md:表格

表格的作用在於清晰展示資料橫向和縱向關係,可儘量避免合併單元格。

編號|姓名|成績

:-|:-:|-

1001

|孫大聖|

971002

|豬小能|

871003

|沙程式設計|

39

無門檻學習程式設計師文件神器:Markdown

後記

整理好的文件可以利用VSCode的匯出功能匯出為PDF格式,與小夥伴分享了。

無門檻學習程式設計師文件神器:Markdown

選擇pdf進行匯出(介面上沒有明顯提示…),會在md文件同目錄下生成pdf檔案。

無門檻學習程式設計師文件神器:Markdown

有了以上基本規則的學習,小夥伴們就可以利用Markdown在學習和工作中自由翱翔了!