一、Markdown產品說明
mkpad 是一款永久免費的 windows 端 MarkDown 編輯器。
mkpad 由[貝一科技](www.qdyongfengstone.com) 開發。mkpad 是 [blapad](www.blapad.com) 旗下產品。
mkpad 不僅支持 markdown 基礎語法,也支持:
- 語法高亮
- 數學公式
- 流程圖
- 特有 `<mk.../>`語法,極大的方便了 css 樣式擴展、js 腳本植入
mkpad 還提供了如下特色功能:
- 打開 rtf 文件或粘貼 rtf 內容(從 word 或 wps 中拷貝)
- 打開 html 文件或粘貼 html 內容
- 直接粘貼圖片
- 圖片可以以 base64 編碼形式存在,方便上傳到互聯網上而保證圖片不丟失
- 自動編號,將一級、二級、三級自動形成序號,免去了自己編號的麻煩
- 放映模式,可以將 .md 文件直接以 PPT 的模式放映,團隊工作時非常方便
另外,mkpad提供的文本編輯器也是非常好用的,包含markdown語法高亮、html/css/javascript語法高亮、顯示行號、html代碼折疊、自動換行等功能。
二、Markdown操作界面
三、Markdown使用說明
段落和換行
一個 Markdown 段落是由一個或多個連續的文本行組成,它的前后要有一個以上的空行(空行的定義是顯示上看起來像是空的,便會被視為空行。比方說,若某一行只包含空格和制 表符,則該行也會被視為空行)。普通段落不該用空格或制表符來縮進。Markdown 允許段落內的強迫換行(插入換行符)。
標題
Markdown支持兩種標題的語法,類 Setext 和類 Atx 形式。
類 Setext 形式是用底線的形式,利用 = (最高階標題)和 - (第二階標題),例如:
Thisisan H1 ============= Thisisan H2 -------------
任何數量的 = 和 - 都可以有效果。
類 Atx 形式則是在行首插入 1 到 6 個 # ,對應到標題 1 到 6 階,例如:
# 這是 H1## 這是 H2###### 這是 H6
目錄
使用 [TOC] 生成目錄。
如果你的標題都是按照 Markdown 語法書寫的話,可以自動生成層級目錄。 [TOC] 標記可能只能放在一級標題的前面,視不同的編譯器而定。
列表
Markdown 支持有序列表和無序列表。
無序列表使用星號、加號或是減號作為列表標記:
*Red*Green*Blue
等同于:
+ Red+ Green+ Blue
也等同于:
- Red- Green- Blue
有序列表則使用數字接著一個英文句點:
1.Bird2.McHale3.Parish
列表項目標記通常是放在最左邊,但是其實也可以縮進,最多 3 個空格,項目標記后面則一定要接著至少一個空格或制表符。
如果列表項目間用空行分開,在輸出 HTML 時 Markdown 就會將項目內容用
標簽包起來。
列表項目可以包含多個段落:
1.Thisisa list itemwithtwo paragraphs. Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi, viverra nec, fringillain, laoreet vitae, risus. Donec sit amet nisl. Aliquam semper ipsum sit amet velit.2.Suspendisse id sem consectetuer libero luctus adipiscing.
如果要放代碼區塊的話,該區塊就需要縮進兩次,也就是 8 個空格或是 2 個制表符:
* 一列表項包含一個列表區塊:<代碼寫在這>
表格
具體使用方式請看示例。
------:為右對齊。:------為左對齊。:------:為居中對齊。 ------- 為使用默認居中對齊。
示例
| ABCD | EFGH | IJKL | | -----|:----:|----:|| a | b | c | | d | e | f | | g | h | i |
每個Markdown解析器都不一樣,可能左右居中對齊方式的表示方式不一樣。
代碼區塊
和程序相關的寫作或是標簽語言原始碼通常會有已經排版好的代碼區塊,通常這些區塊我們并不希望它以一般段落文件的方式去排版,而是照原來的樣子顯示,Markdown 會用<pre>和<code>標簽來把代碼區塊包起來。
要在 Markdown 中建立代碼區塊很簡單,只要縮進 4 個空格或是 1 個制表符就可以。
這個每行一階的縮進(4 個空格或是 1 個制表符),都會被移除。
一個代碼區塊會一直持續到沒有縮進的那一行(或是文件結尾)。
代碼區塊中,一般的 Markdown 語法不會被轉換,像是星號便只是星號。
分隔線
你可以在一行中用三個以上的星號、減號、底線來建立一個分隔線,行內不能有其他東西。你也可以在星號或是減號中間插入空格。下面每種寫法都可以建立分隔線:
** *********- - - ---------------------------------------
區段元素
鏈接
Markdown 支持兩種形式的鏈接語法: 行內式和參考式兩種形式。
不管是哪一種,鏈接文字都是用 [方括號] 來標記。
要建立一個行內式的鏈接,只要在方塊括號后面緊接著圓括號并插入網址鏈接即可,如果你還想要加上鏈接的 title 文字,只要在網址后面,用雙引號把 title 文字包起來即可。
如果你是要鏈接到同樣主機的資源,你可以使用相對路徑:
See my [About](/about/) page for details.
參考式的鏈接是在鏈接文字的括號后面再接上另一個方括號,而在第二個方括號里面要填入用以辨識鏈接的標記:
This is [an example][id] reference-style link. 你也可以選擇性地在兩個方括號中間加上一個空格: This is [an example] [id] reference-style link. 接著,在文件的任意處,你可以把這個標記的鏈接內容定義出來: [id]:http://example.com/ "Optional Title Here"
鏈接內容定義的形式為:
*方括號(前面可以選擇性地加上至多三個空格來縮進),里面輸入鏈接文字 *接著一個冒號 *接著一個以上的空格或制表符 *接著鏈接的網址 *選擇性地接著 title 內容,可以用單引號、雙引號或是括弧包著
下面這三種鏈接的定義都是相同:
[foo]:http://example.com/ "Optional Title Here"[foo]:http://example.com/ 'Optional Title Here'[foo]:http://example.com/ (Optional Title Here)
請注意:有一個已知的問題是 Markdown.pl 1.0.1 會忽略單引號包起來的鏈接 title。
鏈接網址也可以用方括號包起來:
[id]:<http://example.com/> "Optional Title Here"
你也可以把 title 屬性放到下一行,也可以加一些縮進,若網址太長的話,這樣會比較好看:
[id]:http://example.com/longish/path/to/resource/here"Optional Title Here"
網址定義只有在產生鏈接的時候用到,并不會直接出現在文件之中。
鏈接辨別標簽可以有字母、數字、空白和標點符號,但是并不區分大小寫,因此下面兩個鏈接是一樣的:
[link text][a] [link text][A]
隱式鏈接標記功能讓你可以省略指定鏈接標記,這種情形下,鏈接標記會視為等同于鏈接文字,要用隱式鏈接標記只要在鏈接文字后面加上一個空的方括號,如果你要讓 "Google" 鏈接到 google.com,你可以簡化成:
[Google][]
然后定義鏈接內容:
[Google]:http://google.com/
強調
Markdown 使用星號 * 或底線 _ 作為標記強調字詞的符號,被 * 或 _ 包圍的字詞會被轉成用<em>標簽包圍,用兩個 * 或 _ 包起來的話,則會被轉成<strong>,例如:
*single asterisks*_single underscores_**double asterisks**__double underscores__
會轉成:
<em>single asterisks</em><em>single underscores</em><strong>double asterisks</strong><strong>double underscores</strong>
你可以隨便用你喜歡的樣式,唯一的限制是,你用什么符號開啟標簽,就要用什么符號結束。
強調也可以直接插在文字中間:
un*frigging*believable
代碼
如果要標記一小段行內代碼,你可以用反引號 ` 把它包起來,例如:
Usethe`printf()`function.
如果要在代碼區段內插入反引號,你可以用多個反引號來開啟和結束代碼區段:
``Thereisa literal backtick here.``
圖片
Markdown 使用一種和鏈接很相似的語法來標記圖片,同樣也允許兩種樣式: 行內式和參考式。
行內式的圖片語法看起來像是:
 
詳細敘述如下:
*一個驚嘆號 ! *接著一個方括號,里面放上圖片的替代文字 *接著一個普通括號,里面放上圖片的網址,最后還可以用引號包住并加上 選擇性的'title'文字。
參考式的圖片語法則長得像這樣:
![Alt text][id] 「id」是圖片參考的名稱,圖片參考的定義方式則和連結參考一樣: [id]:url/to/image "Optional title attribute"
到目前為止, Markdown 還沒有辦法指定圖片的寬高,如果你需要的話,你可以使用普通的<img>標簽。
數學公式
LaTeX的數學公式有兩種:行中公式和獨立公式。行中公式放在文中與其它文字混編,獨立公式單獨成行。
行中公式可以用如下兩種方法表示:
\(數學公式\) 或數學公式
獨立公式可以用如下兩種方法表示:
\[數學公式\] 或數學公式
自動鏈接
Markdown 支持以比較簡短的自動鏈接形式來處理網址和電子郵件信箱,只要是用方括號包起來, Markdown 就會自動把它轉成鏈接。一般網址的鏈接文字就和鏈接地址一樣,例如:
<http://example.com/>Markdown 會轉為: <a >http://example.com/</a>
郵址的自動鏈接也很類似。
在瀏覽器里面,這段字串(其實是 address@example.com)會變成一個可以點擊的「address@example.com」鏈接。
反斜杠
Markdown 可以利用反斜杠來插入一些在語法中有其它意義的符號,例如:如果你想要取消星號加在文字旁邊的強調效果,你可以在星號的前面加上反斜杠:
\*literal asterisks\*
Markdown 支持以下這些符號前面加上反斜杠來幫助插入普通的符號:
\ 反斜線 ` 反引號*星號 _ 底線 {} 花括號 [] 方括號 () 括弧# 井字號+加號-減號 . 英文句點 ! 驚嘆號
流程圖
流程圖的語法大體分為兩段,第一段用來定義元素,第二段用來連接元素
定義元素階段的語法是
tag=>type: content:>url
tag就是一個標簽,在第二段連接元素時用。 type是這個標簽的類型,有6中類型,分別為:
startendoperation subroutine condition inputoutput
content就是在框框中要寫的內容,中英文均可,但有一點需要特別注意,就是type后的冒號與文本之間一定要有個空格,沒空格會出問題。 url就是一個連接,與框框中的文本相綁定連接元素階段的語法,直接用->來連接兩個元素,需要注意的是condition類型,因為他有yes和no兩個分支,所以要寫成c2(yes)->io->e c2(no)->op2->e
刪除線
使用 ~~ 表示刪除線。
~~這是一條刪除線~~
注意 ~~ 要添加刪除線的文字之間不能有空格。
樣式
請自行用F12查看,無特殊說明