Markdown基礎語法

lsgxeva發表於2024-03-18

markdown基礎語法介紹(本文最先發布在github:markdown

標題

markdown的標題有兩種寫法

setext方式

原始碼如下:

This is an H1
=============

This is an H2
-------------

效果如下:
這裡寫圖片描述

atx方式

原始碼如下:

# This is an H1

## This is an H2

### This is an H3

#### This is an H4

##### This is an H5

###### This is an H6

備註:如果你願意,也可以在標題末尾加上任意數量的#來關閉標籤,就像這樣的:# This is an H1 #

效果如下:
這裡寫圖片描述

塊引用

markdown的塊引用有幾個特點:
1. 懶人模式,一大段文字的引用,可以只在第一行前面加上塊引用標籤
2. 巢狀引用,引用塊裡面還可以巢狀引用塊
3. 巢狀其他markdown元素,例如:列表等

語法

原始碼如下:

> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
> consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
> Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
> 
> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
> id sem consectetuer libero luctus adipiscing.

效果如下:
這裡寫圖片描述

巢狀

原始碼如下:

> ## This is a header.
> 
> 1.   This is the first list item.
> 2.   This is the second list item.
> 
> Here's some example code:
> 
>     return shell_exec("echo $input | $markdown_script");

效果如下:
這裡寫圖片描述

列表

markdown的列表分有序列表和無序列表兩種,不管是有序還是無序列表都支援多級子列表

有序列表

原始碼如下:

1. Bird
2. McHale
3. Parish

效果如下:
這裡寫圖片描述

無序列表

原始碼如下:

* Red
* Green
* Blue

效果如下:
這裡寫圖片描述
無序列表的起始符號還可以是:-/+(減號/加號)

多級列表

原始碼如下:

1. A
2. B
    1. B1
    2. B2
3. C


* A
* B
    * B1
    * B2
* C

效果如下:
這裡寫圖片描述

程式碼塊

markdown的程式碼庫以四個以上空格或者一個TAB開頭

原始碼如下:

import os
os.getcwd()
print("hello")

if __file__ == "__main__":
    print("main")
else:
    print("other")

看到效果了嗎?

橫線

markdown的橫線有多種

原始碼如下:

* * *

***

*****

- - -

---------------------------------------

效果如下:
這裡寫圖片描述

連結

原始碼如下:

[baidu](www.baidu.com)

效果如下:
這裡寫圖片描述

如果想要顯示圖片:![image description](image url)

表格

原始碼如下:

| item | description |
| --- | --- |
| name | name of student |
| age | age of student |

效果如下:
這裡寫圖片描述

說明:第二行的| – |可以控制對其方式
* | :— | 表示左對齊
* | —: | 表示右對齊
* | :—: | 表示居中對其