Markdown語法經典寫作教程 我展示的是GitArtOS一級標題 GitArtOS一級標題

1. Markdown簡介

1.1 介紹

Markdown 是一種輕量級標記語言,它允許人們使用易讀易寫的純文本格式編寫文檔。
Markdown 語言在 2004 由約翰·格魯伯(英語:John Gruber)創建。
Markdown 編寫的文檔可以導出 HTMLWord圖像PDFEpub 等多種格式的文檔。
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第三項

顯示效果:

  1. GitArtOS第一項
  2. GitArtOS第二項
  3. GitArtOS第三項
4.3 列表嵌套

列表嵌套只需在子列表中的選項前面添加四個空格即可:

1. 第一項:
    - 第一項嵌套的第一個元素
    - 第一項嵌套的第二個元素
2. 第二項:
    - 第二項嵌套的第一個元素
    - 第二項嵌套的第二個元素

顯示效果

  1. 第一項:
    • 第一項嵌套的第一個元素
    • 第一項嵌套的第二個元素
  2. 第二項:
    • 第二項嵌套的第一個元素
    • 第二項嵌套的第二個元素

5.Markdown 區塊

5.1 區塊引用

Markdown 區塊引用是在段落開頭使用>符號 ,然後後面緊跟一個空格符號

> 區塊引用
> GitArtOS雜耍
> 學雜耍,我是認真的

效果如下:

區塊引用
GitArtOS雜耍
學雜耍,我是認真的

5.2 區塊嵌套

另外區塊是可以嵌套的,一個> 符號是最外層,兩個> 符號是第一層嵌套,以此類推:

> GitArtOS外套
> > GitArtOS內衣嵌套
> > > GitArtOS內褲嵌套
> > > > 你們真壞!!

效果:

GitArtOS外套

GitArtOS內衣嵌套

GitArtOS內褲嵌套

你們真壞!!

5.3 區塊、列表正向雜交使用

區塊使用列表實例

> 區塊中使用列表
> 1. 第一項
> 2. 第二項
> + 第一項
> + 第二項
> + 第三項

顯示效果

區塊中使用列表

  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雜耍教程](https://www.jianshu.com/p/a41087cbe901)

顯示效果:

這是一個鏈接 Markdown雜耍教程

當然你也可以直接使用鏈接地址:

<https://www.jianshu.com/p/a41087cbe901>

顯示效果如下:

https://www.jianshu.com/p/a41087cbe901

7.2 高級鏈接

我們可以通過變量來設置一個鏈接,變量賦值在文檔末尾進行:

這個鏈接用 1 作爲網址變量 [GitArtOS][1]
這個鏈接用 雜耍 作爲網址變量 [GitArtOS][雜耍]
然後在文檔的結尾爲變量賦值(網址)

  [1]: https://www.jianshu.com/p/a41087cbe901
  [雜耍]: https://www.jianshu.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 公式

當你需要在編輯器中插入數學公式時,可以使用兩個美元符 $$ 包裹 TeXLaTeX格式的數學公式來實現。提交後,問答和文章頁會根據需要加載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條。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章