1. Markdown
簡介
1.1 介紹
Markdown
是一種輕量級標記語言,它允許人們使用易讀易寫的純文本格式編寫文檔。
Markdown
語言在 2004 由約翰·格魯伯(英語:John Gruber
)創建。
Markdown
編寫的文檔可以導出 HTML
、Word
、圖像
、PDF
、Epub
等多種格式的文檔。
Markdown
編寫的文檔后綴為 .md
, .markdown
。
1.2 Markdown
應用
Markdown
能被使用來撰寫電子書
,如:Gitbook
。
當前許多網站都廣泛使用 Markdown
來撰寫幫助文檔或是用于論壇上發表消息。例如:GitHub、簡書、reddit、Diaspora、Stack Exchange、OpenStreetMap 、SourceForge
等。
目前主流編輯器:我推薦
Typora
編輯器,Typora
支持MacOS 、Windows、Linux
平臺,且包含多種主題,編輯后直接渲染出效果。支持導出HTML、PDF、Word、圖片
等多種類型文件。
Typora
官網:https://typora.io/
2.Markdown
標題
2.1使用 =
和-
標記一級和二級標題
我展示的是GitArtOS一級標題
======
效果:
我展示的是GitArtOS一級標題
我展示的是GitArtOS二級標題
-----------------
效果:
我展示的是GitArtOS二級標題
2.2 使用#
號標記 可表示 1-6
級標題,一級標題對應一個 #
號,二級標題對應兩個#
號,以此類推
。
# GitArtOS一級標題
## GitArtOS二級標題
### GitArtOS三級標題
#### GitArtOS四級標題
##### GitArtOS五級標題
###### GitArtOS六級標題
效果如下:
GitArtOS一級標題
GitArtOS二級標題
GitArtOS三級標題
GitArtOS四級標題
GitArtOS五級標題
GitArtOS六級標題
3.Markdown
段落
3.1Markdown
段落沒有特殊的格式,直接編寫文字就好,段落的換行是使用兩個以上
空格加上回車
wowoowoooowowoGitArtOS
wwoowowowowowoGitArtOS
效果:
wowoowoooowowo
wwoowowowowowo
3.2 當然也可以在段落后面使用一個空行來表示重新開始一個段落。
wowoowoooowowoGitArtOS
wwoowowowowowoGitArtOS
效果:
wowoowoooowowoGitArtOS
wwoowowowowowoGitArtOS
3.3 字體
Markdown
可以使用以下幾種字體:
*GitArtOS斜體文本*
_GitArtOS斜體文本_
**GitArtOS粗體文本**
__GitArtOS粗體文本__
***GitArtOS粗斜體文本***
___GitArtOS粗斜體文本___
效果:
GitArtOS斜體文本
GitArtOS斜體文本
GitArtOS粗體文本
GitArtOS粗體文本
GitArtOS粗斜體文本
GitArtOS粗斜體文本
3.4 分隔線
你可以在一行中用三個以上的星號、減號、底線來建立一個分隔線,行內不能有其他東西。你也可以在星號或是減號中間插入空格。下面每種寫法都可以建立分隔線:
***
* * *
*****
- - -
----------
效果如下:
3.5 刪除線
如果段落上的文字要添加刪除線,只需要在文字的兩端加上兩個波浪線 ~~
即可,實例如下:
GitArtOSGitArtOSGitArtOS.COM
GitArtOSGitArtOSGitArtOSGitArtOSGitArtOS.COM
~~GitArtOSGitArtOSGitArtOSGitArtOS.COM~~
效果:
GitArtOSGitArtOSGitArtOS.COM
GitArtOSGitArtOSGitArtOSGitArtOSGitArtOS.COM
GitArtOSGitArtOSGitArtOSGitArtOS.COM
3.6 下劃線
下劃線
可以通過 HTML
的 <u>
標簽來實現:
<u>帶下劃線文本</u>
效果:
3.7 腳注
腳注
是對文本
的補充說明。
Markdown
腳注的格式如下:
[^要注明的文本]
例如:
創建腳注格式類似這樣: [^RUNOOB]。
[^RUNOOB]: GitArtOS
效果:
4.Markdown
列表
Markdown
支持有序列表和無序列表。
4.1 無序列表
無序列表使用星號(*
)、加號(+
)或是減號(-
)作為列表標記,這些標記后面要添加一個空格
,然后再填寫內容:
* GitArtOS第一項
* GitArtOS第二項
* GitArtOS第三項
+ GitArtOS第一項
+ GitArtOS第二項
+ GitArtOS第三項
- GitArtOS第一項
- GitArtOS第二項
- GitArtOS第三項
顯示效果:
- GitArtOS第一項
- GitArtOS第二項
- GitArtOS第三項
- GitArtOS第一項
- GitArtOS第二項
- GitArtOS第三項
- GitArtOS第一項
- GitArtOS第二項
- GitArtOS第三項
4.2 有序列表
使用數字并加上 . 號來表示,如:
1. GitArtOS第一項
2. GitArtOS第二項
3. GitArtOS第三項
顯示效果:
- GitArtOS第一項
- GitArtOS第二項
- GitArtOS第三項
4.3 列表嵌套
列表嵌套只需在子列表中的選項前面添加四個空格
即可:
1. 第一項:
- 第一項嵌套的第一個元素
- 第一項嵌套的第二個元素
2. 第二項:
- 第二項嵌套的第一個元素
- 第二項嵌套的第二個元素
顯示效果:
- 第一項:
- 第一項嵌套的第一個元素
- 第一項嵌套的第二個元素
- 第二項:
- 第二項嵌套的第一個元素
- 第二項嵌套的第二個元素
5.Markdown
區塊
5.1 區塊引用
Markdown
區塊引用是在段落開頭使用>
符號 ,然后后面緊跟一個空格符號
:
> 區塊引用
> GitArtOS雜耍
> 學雜耍,我是認真的
效果
如下:
區塊引用
GitArtOS雜耍
學雜耍,我是認真的
5.2 區塊嵌套
另外區塊
是可以嵌套
的,一個>
符號是最外層,兩個>
符號是第一層嵌套,以此類推:
> GitArtOS外套
> > GitArtOS內衣嵌套
> > > GitArtOS內褲嵌套
> > > > 你們真壞!!
效果:
GitArtOS外套
GitArtOS內衣嵌套
GitArtOS內褲嵌套
你們真壞!!
5.3 區塊、列表正向雜交使用
區塊使用列表實例
> 區塊中使用列表
> 1. 第一項
> 2. 第二項
> + 第一項
> + 第二項
> + 第三項
顯示效果:
區塊中使用列表
- 第一項
- 第二項
- 第一項
- 第二項
- 第三項
5.4 區塊、列表反向雜交使用
列表中使用區塊:如果要在列表項目內放進區塊,那么就需要在 > 前添加四個空格的縮進。列表中使用區塊實例如下:
* 第一項
> GitArtOS學雜耍嗎?
> 學雜耍,我是認真的
* 第二項
顯示效果:
- 第一項
GitArtOS學雜耍嗎?
學雜耍,我是認真的 - 第二項
6. Markdown
代碼---程序員環節了
6.2 簡單的
如果是段落上的一個函數或片段的代碼可以用反引號把它包起來(`),例如:
`gitartos()` 函數
顯示效果:
gitartos()
函數
6.2 和編程語言相結合的
你也可以用``` 包裹一段代碼,并指定一種語言(也可以不指定):
/```javascript
$(document).ready(function () {
alert('RUNOOB');
});
```/
顯示效果(去掉上面的/
):
$(document).ready(function () {
alert('RUNOOB');
});
7.Markdown
鏈接
7.1 簡單鏈接
鏈接使用方法如下:
[鏈接名稱](鏈接地址)
或者
<鏈接地址>
舉個??:
這是一個鏈接 [Markdown雜耍教程](http://www.lxweimin.com/p/a41087cbe901)
顯示效果:
這是一個鏈接 Markdown雜耍教程
當然你也可以直接使用鏈接地址:
<http://www.lxweimin.com/p/a41087cbe901>
顯示效果如下:
http://www.lxweimin.com/p/a41087cbe901
7.2 高級鏈接
我們可以通過變量
來設置一個鏈接,變量賦值在文檔末尾進行:
這個鏈接用 1 作為網址變量 [GitArtOS][1]
這個鏈接用 雜耍 作為網址變量 [GitArtOS][雜耍]
然后在文檔的結尾為變量賦值(網址)
[1]: http://www.lxweimin.com/p/a41087cbe901
[雜耍]: http://www.lxweimin.com/p/a41087cbe901
顯示效果:
這個鏈接用 1 作為網址變量 GitArtOS
這個鏈接用 雜耍 作為網址變量 GitArtOS
然后在文檔的結尾為變量賦值(網址)
8.Markdown
圖片
Markdown
圖片語法格式如下:
[圖片上傳失敗...(image-a1511f-1613818429292)]
[圖片上傳失敗...(image-14ffcf-1613818429295)]
8.1 當然,你也可以像網址那樣對圖片網址使用變量:
這個鏈接用 1 作為網址變量 [GitArtOS][1].
然后在文檔的結尾為變量賦值(網址)
[1]: https://upload-images.jianshu.io/upload_images/19168340-e112b50cf76f07af.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240
這個鏈接用 1 作為網址變量 GitArtOS.
然后在文檔的結尾為變量賦值(網址)
8.2 Markdown
還沒有辦法指定圖片的高度與寬度,如果你需要的話,你可以使用普通的<img>
標簽。
<img src="https://upload-images.jianshu.io/upload_images/19168340-e112b50cf76f07af.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240" width="50%">
顯示結果如下:
9. Markdown
表格
Markdown
制作表格使用 | 來分隔不同的單元格,使用-
來分隔表頭和其他行。
語法格式如下:
| 表頭 | 表頭 |
| ---- | ---- |
| 單元格 | 單元格 |
| 單元格 | 單元格 |
顯示效果:
表頭 | 表頭 |
---|---|
單元格 | 單元格 |
單元格 | 單元格 |
9.1 對齊方式
我們可以設置表格的對齊方式:
-: 設置內容和標題欄居右對齊。
:- 設置內容和標題欄居左對齊。
:-: 設置內容和標題欄居中對齊。
舉個??:
| 左對齊 | 右對齊 | 居中對齊 |
| :-----| ----: | :----: |
| 單元格 | 單元格 | 單元格 |
| 單元格 | 單元格 | 單元格 |
以上代碼顯示結果如下:
左對齊 | 右對齊 | 居中對齊 |
---|---|---|
單元格 | 單元格 | 單元格 |
單元格 | 單元格 | 單元格 |
10.高級技巧
支持的HTML
元素不在 Markdown 涵蓋范圍之內的標簽,都可以直接在文檔里面用 HTML 撰寫。目前支持的HTML
元素有:<kbd> <b> <i> <em> <sup> <sub> <br>
等 ,如:
使用 <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd> 重啟電腦
顯示效果:
10.1 轉義
Markdown
使用了很多特殊符號來表示特定的意義,如果需要顯示特定的符號則需要使用轉義字符,Markdown
使用反斜杠轉義特殊字符:
**文本加粗**
\*\* 正常顯示星號 \*\*
顯示效果
:
文本加粗
** 正常顯示星號 **
10.2 其他特殊符號
Markdown
支持以下這些符號前面加上反斜杠來幫助插入普通的符號:
\ 反斜線
` 反引號
* 星號
_ 下劃線
{} 花括號
[] 方括號
() 小括號
# 井字號
+ 加號
- 減號
. 英文句點
! 感嘆號
10.3 公式
當你需要在編輯器中插入數學公式時,可以使用兩個美元符 $$
包裹 TeX
或 LaTeX
格式的數學公式來實現。提交后,問答和文章頁會根據需要加載Mathjax
對數學公式進行渲染。如:
$$
\mathbf{V}_1 \times \mathbf{V}_2 = \begin{vmatrix}
\mathbf{i} & \mathbf{j} & \mathbf{k} \\
\frac{\partial X}{\partial u} & \frac{\partial Y}{\partial u} & 0 \\
\frac{\partial X}{\partial v} & \frac{\partial Y}{\partial v} & 0 \\
\end{vmatrix}
${$tep1}{\style{visibility:hidden}{(x+1)(x+1)}}
$$
輸出結果為:
雜耍搞完,收藏起來,點贊關注我
GitArtOS
吧,終于湊足了10條。