Markdown快速入門

Markdown快速入門


  1. 標題、區(qū)塊引用

(1)用底線的形式,利用 = (最高階標題)和 - (第二階標題)
(2)在行首插入 1 到 6 個 # ,對應到標題 1 到 6 階
(3)區(qū)塊引用則使用 email 形式的 '>' 角括號。

Markdown 語法:

最高階標題
========
第二階標題
--------
### H3
> 這是區(qū)塊引用
> > 這是區(qū)塊引用的嵌套
> ## 在區(qū)塊引用里使用H2
> 只在整個段落的第一行最前面加上 >只在整個段落的第一行最前面加上只在
整個段落的第一行最前面加上只在整個段落的第一行最前面加上

輸出 HTML 為:

image.png

  1. 修辭和強調(diào)

Markdown 使用星號( * )和底線( _ )作為標記強調(diào)字詞的符號,被 * 或 _ 包圍的字詞為斜體,用兩個 * 或 _ 包起來的話,則加粗
星號(*)和底線你可以任意選擇,唯一的限制是,你用什么符號開啟標簽,就要用什么符號結束。

Markdown 語法:

*斜體*.
_斜體_
**加粗**
__加粗__
\*星號或底線前插入反斜線,會被渲染成普通的星號或底線\*
如果星號或底線 * 和 _ 兩邊都有空白的話,會被渲染成普通的星號或底線

輸出 HTML 為:

斜體.
斜體
加粗
加粗
*星號或底線前插入反斜線,會被渲染成普通的星號或底線*
如果星號或底線 * 和 _ 兩邊都有空白的話,會被渲染成普通的星號或底線


  1. 代碼區(qū)塊

(1)只要縮進 4 個空格或是 1 個制表符(Tab)就可建立代碼區(qū)塊
(2)一個代碼區(qū)塊會一直持續(xù)到?jīng)]有縮進的那一行(或是文件結尾)
(3)代碼區(qū)塊里面, & 、 < 和 > 會自動轉(zhuǎn)成 HTML 實體,你只需要復制貼上HTML 原始碼,再加上縮進就可以了,剩下的 Markdown 都會幫你處理
(4)代碼區(qū)塊中,一般的 Markdown 語法不會被轉(zhuǎn)換,像是星號便只是星號,這表示你可以在代碼區(qū)塊中以 Markdown 語法撰寫 Markdown 語法相關的文件。

Markdown 語法:

這是一個普通段落:

    這是一個代碼區(qū)塊(上面必須空一行)。
     <div class="footer">
        &copy; 2004 Foo Corporation
     </div>

輸出 HTML 為:

這是一個普通段落:

這是一個代碼區(qū)塊(上面必須空一行)。
 <div class="footer">
    &copy; 2004 Foo Corporation
 </div>

  1. 代碼

(1)如果要標記一小段行內(nèi)代碼,你可以用反引號把它包起來(`)
(2)如果要在代碼區(qū)段內(nèi)插入反引號,你可以用多個反引號來開啟和結束代碼區(qū)段:
(3)在代碼區(qū)段內(nèi),& 和尖括號都會被自動地轉(zhuǎn)成 HTML 實體

Markdown 語法:

標記一小段行內(nèi)代碼 `printf()`用反引號把它包起來(`)
``要在代碼區(qū)段內(nèi)插入反引號 (`) 可以用多個反引號來開啟和結束代碼區(qū)段``
在區(qū)段的中插入反引號`` `foo` ``
Please don't use any `<blink>` tags.

輸出 HTML 為:

標記一小段行內(nèi)代碼 printf()用反引號把它包起來(`)

要在代碼區(qū)段內(nèi)插入反引號 (`) 可以用多個反引號來開啟和結束代碼區(qū)段

在區(qū)段的中插入反引號`foo`

Please don't use any <blink> tags.


  1. 列表

Markdown 支持有序列表和無序列表,項目標記后面則一定要接著至少一個空格或制表符(符號后面至少要空一個空格)
(1)無序列表使用星號、加號或是減號作為列表標記
(2)有序列表則使用數(shù)字接著一個英文句點
(3)重點在于,有序列表,可以完全不用在意數(shù)字的正確性。
(4)用Tab可以縮進分層

Markdown 語法:

*   無
*   序
*   列
+   表
+   ....
+   無
-   序
-   列
-   表

中間要用文字隔開

1.  有
    4.  序
    3.  列
        2.  表(不用在意數(shù)字順序,無影響,但最好從1開始)
1986\. 在行首出現(xiàn)數(shù)字-句點-空白,要避免這樣的狀況,你可以在句點前面加上反斜杠。

輸出 HTML 為:

  • ....

中間要用文字隔開

      1. 表(不用在意數(shù)字順序,無影響,但最好從1開始)

1986. 在行首出現(xiàn)數(shù)字-句點-空白,要避免這樣的狀況,你可以在句點前面加上反斜杠。


  1. 鏈接

Markdown 支持兩種形式的鏈接語法: 行內(nèi)式和參考式兩種形式,鏈接文字都是用 [方括號] 來標記。
(1)行內(nèi)式,方塊括號內(nèi)是文字,后面圓括號里面是網(wǎng)址鏈接即可,如果你還想要加上鏈接的 title 文字,只要在網(wǎng)址后面,用雙引號把 title 文字包起來即可
(2)如果你是要鏈接到同樣主機的資源,你可以使用相對路徑:

Markdown 語法:

[百度鏈接](https://www.baidu.com/ "我是Title") 行內(nèi)式
[About](/about/) 鏈接到同樣主機的資源,你可以使用相對路徑

輸出 HTML 為:

百度鏈接 行內(nèi)式
About 鏈接到同樣主機的資源,你可以使用相對路徑


  1. 圖片

Markdown 使用一種和鏈接很相似的語法來標記圖片,允許兩種樣式: 行內(nèi)式和參考式。
(1)行內(nèi)式,方塊括號內(nèi)是文字,后面圓括號里面是網(wǎng)址鏈接即可,如果你還想要加上鏈接的 title 文字,只要在網(wǎng)址后面,用雙引號把 title 文字包起來即可
(2)詳細敘述如下:

  • 一個驚嘆號 !
  • 接著一個方括號,里面放上圖片的替代文字
  • 接著一個普通括號,里面放上圖片的網(wǎng)址,最后還可以用引號包住并加上 選擇性的 'title' 文字。

Markdown 語法:

![當圖片不現(xiàn)實的時候我出現(xiàn)](/path/to/img.jpg "當鼠標放在上面的時候我出現(xiàn)")
![Alt text](./1524562628039.png)

輸出 HTML 為:

當圖片不現(xiàn)實的時候我出現(xiàn)

Alt text

  1. 分割線

你可以在一行中用三個以上的星號、減號、底線來建立一個分隔線,行內(nèi)不能有其他東西。你也可以在星號或是減號中間插入空格。

Markdown 語法:

* * *
***
*****
- - -
---------------------------------------

輸出 HTML 為:







  1. 反斜杠

Markdown 可以利用反斜杠來插入一些在語法中有其它意義的符號,例如:如果你想要用星號加在文字旁邊的方式來做出強調(diào)效果(但不用 <em> 標簽),你可以在星號的前面加上反斜杠

Markdown 語法:

Markdown 支持以下這些符號前面加上反斜杠來幫助插入普通的符號:
\   反斜線
`   反引號
*   星號
_   底線
{}  花括號
[]  方括號
()  括弧
#   井字號
+   加號
-   減號
.   英文句點
!   驚嘆號

\*literal asterisks\*

輸出 HTML 為:

*literal asterisks*

最后編輯于
?著作權歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時請結合常識與多方信息審慎甄別。
平臺聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點,簡書系信息發(fā)布平臺,僅提供信息存儲服務。

相關閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容