1. 程式人生 > >使用Atom編寫.md檔案、Markdown基本語法

使用Atom編寫.md檔案、Markdown基本語法

Atom介紹:

Atom 是 Github 專門為程式設計師推出的一個跨平臺文字編輯器,是當前主流的跨平臺的三大編輯器(Atom,sublime,vscode)之一。Atom內建對markdown的支援,能夠方便的進行解析預覽。

Markdown是一種可以使用普通文字編輯器編寫的標記語言,通過簡單的標記語法,它可以使普通文字內容具有一定的格式。

如何使Atom能編寫.md檔案:

首先我們要安裝Atom。去官網下載安裝對應你平臺的Atom版本,安裝完成。

然後開啟Atom軟體。

開啟任意一個.md檔案(markdown格式的檔案),也可以自己新建一個.md檔案再開啟,開啟方式為選單欄File->Open file。

windows下使用快捷鍵 ctrl + shift + p,開啟命令輸入框

輸入 markdown preview toggle,enter安裝,然後ctrl+shift+m即實現左邊編輯,右邊實時預覽。

我們也可以通過選單欄Packages->Markdown Preview->Toggle Treview實現左邊編輯,右邊實時預覽。

Atom外掛分為內建的和擴充套件的。其中Markdown Preview是Atom的內建外掛。

如果要很好的編寫Markdown檔案,還要安裝下列外掛:

windows下使用快捷鍵 ctrl + shift + p,開啟命令輸入框,輸入 settings view install packages and themes,也可以通過選單欄File->Setting->Install;

開啟搜尋框在搜尋框依次輸入下列外掛名,點選Packages按鈕,在搜尋結果中點選Install按鈕即可安裝。

markdown-preview-plus(在markdown-preview的基礎上做了擴充套件,支援預覽實時渲染,支援Latex公式)
markdown-scroll-sync(同步滾動)
language-markdown(程式碼增強)
markdown-img-paste(圖片貼上等功能)
qiniu-uploader(可選,可以不安裝,圖片上傳到雲空間)
markdown-table-editor(便捷的生成表格)
markdown-themeable-pdf 與 pdf-view(pdf生成匯出與pdf預覽)

如:

markdown-preview-plus:

該外掛在markdown-preview的基礎上做了擴充套件,支援預覽實時渲染,支援Latex公式。

ctrl + shift + m 開啟markdown實時預覽

ctrl + shift + x 開啟latex公式支援

同步滾動:

啟用 markdown-scroll-sync 外掛,可以看到Atom已支援同步滾動功能。同步滾動是Markdown編輯器的必備功能,方便翻閱文件修改時能快速定位到預覽的位置。markdown-scroll-sync不僅支援同步滾動,在游標位置發生變更時也會同步滾動,這個功能在很多Markdown編輯器中不具備。

注意:

目前的markdown-scroll-sync不支援markdown-preview-plus,僅支援Atom自帶的markdown-preview。

程式碼增強:

啟用 language-markdown 外掛。一般的Markdown編輯器提供了程式碼著色等基本功能,language-markdown除了能給程式碼著色,還提供了快捷的程式碼片段生成等功能。

圖片貼上:

在安裝外掛之前,插入一幅圖片需要以下步驟:

截圖->為檔案命名並儲存->整理到當前資料夾下->在.md檔案中插入相應命令

我們使用一個圖片儲存在我們.md本地目錄的外掛markdown-img-paste外掛。圖片被儲存的.md所在目錄的assets資料夾中。

安裝完成後插入截圖只需要:

使用任意截圖工具進行截圖(無需儲存,複製到剪下板就行),然後ctr+shift+v ,會自動貼上圖片連結,並生成一個空白的title讓你填寫,並在預覽中顯示出圖片。

qiniu-uploader(只有選擇圖片貼上時上傳圖片到雲空間時才要安裝和設定):

如使用markdown-assistant外掛前必須先設定好qiniu-uploader。

我們先去七牛雲註冊一個個人賬戶。

然後我們設定qiniu-uploader中的四個引數設定:

qiniuAK:

把紅線內容複製貼上到qiniuAK。

qiniuBucket:

點選資料夾樣式圖示,新建一個儲存空間(會要你先實名)。然後在下面填入你新建的空間的名稱。

qiniuDomain:

然後我們可以選擇先用測試域名。注意測試域名30天后會回收。

將測試域名複製貼上到下面:

qiniuSK:

把SK的值複製並貼上到:

表格編輯:

啟用 markdown-table-editor 外掛。

在行首輸入|,然後按Tab,如果|變粉紅則建立了表格。|後可以寫這個單元格的內容,寫完了一個單元格再按|。即建立了一個單元格。

PDF匯出:

啟用 markdown-themeable-pdf 與 pdf-view。

先儲存檔案Ctrl+s,然後在編輯區點選 右鍵->Markdown to PDF或者使用快捷鍵 ctrl + shift + e可以匯出PDF並預覽,匯出的pdf預設與.md在同一資料夾內。

快捷鍵整理:

ctrl + shift + p 開啟命令輸入框

ctrl + shift + m 開啟markdown實時預覽

ctrl + shift + x 開啟latex公式支援

ctrl+s儲存檔案然後ctrl+shift+e匯出pdf並預覽。

markdown基本語法:

Markdown是一種可以使用普通文字編輯器編寫的標記語言,通過簡單的標記語法,它可以使普通文字內容具有一定的格式。

標題:

按照字型大小一共有六級標題。注意,#號後必須有空格。

效果如下:

我們可以在標籤內容結尾+空格+#來閉合標籤,如:

對於一級和二級標題還有另一種表示方法:

 ==表示上面一行為一級標題,--表示上面一行為二級標題。=或-至少2個。

效果如下:

列表:

列表分為有序列表和無序列表。

無序列表可以用* , + , — 來建立,推薦使用*。

如:

有序列表只有下面一種方式,注意,數字後面的點只能是英文的點。有序列表的序號是根據第一行列表的數字順序來的。

    

可以看到列表序號我們設為2,4,7,但實際效果是從2(第一項的設定序號)開始,且後面固定依次遞增。

區塊的引用:

語句前加一個>,這句話就是引用,注意>後要一個空格。

  引用是一個區塊,理論上是應該什麼內容都可以放,比如說:標題,列表,引用等等。

引用可以巢狀使用。   

    

分割線:

分割線可以由* - _(星號,減號,底線)這3個符號的至少3個符號表示且不需要連續,中間有空格也可以。建議用減號。

 

連結:

markdown支援2種連結方式:行內式和引數式,不管是哪一種,連結文字都是用 [方括號] 來標記。

行內式的連結格式是:連結的文字放在[]中,連結地址放在隨後的()中。連結還可以帶title屬性,在連結地址後面空一格,然後用引號引起來。

引數式後面的標籤可以用"",'',或者()括起來均可以。

如:

圖片:

圖片也有2種方式:行內式和引數式。

用法跟連結基本一樣,唯一的不同就是,圖片前面要寫一個!。

效果如下:

程式碼框:

只有一行程式碼,可以在程式碼首尾用``括起來。

多行程式碼,則在程式碼上面一行和程式碼尾部下面一行都用```。

效果如下:

表格:

寫法:

I之間代表一個單元格內的內容。第一行寫完後第二行要寫|:----- |:--- |:------ |表示格式,不寫這一行表格外包起來的線框就不全。

另外:解除安裝左邊表示左對齊,右邊表示右對齊,第三行的資料如果第四行不再寫類似第二行的格式設定,則繼續跟隨第二行的格式。

效果如下:

加粗和傾斜:

加粗:要加粗的語句前後加上兩個星號或下劃線。

傾斜:要傾斜的語句前後加上一個星號或下劃線。

轉義:

這裡列舉一些常用的轉義字元。

     

刪除線:

在要打上刪除線的文字前後加上~~。