最實用的 Markdown 語法教程

2021-09-24 19:30:34 字數 4255 閱讀 1071

前言

最近公司事情不多,每個專案組的人手都夠,我這邊事情不是很忙。因此,老大讓我對markdown語法做乙個系統的培訓。接到任務的時候,我就有點小小激動,終於有「用武之地」了。廢話少說,咱們開始正題吧〜

執行概要

培訓內容:

markdown 是什麼?

markdown 是誰創造的?

為什麼要使用markdown?

markdown怎麼使用?

markdown 都有哪些人在用?

嘗試一下markdown的使用!

markdown 高階語法!

學習目標

通過學習,能對markdown語法有個比較全面的認知,對日常工作寫作排版盡量放棄word、txt等文字工具,改直接用markdown語言寫文件。

學思路一開始,先記住 # 這是標題、## 這是二級標題、### 這是**標題、…這時候你寫一般小文章會開始感覺 md 不錯。

然後,你發現標題不適合做列表,記住了用1. 第一點、- 這一點來列表超級方便。

好吧,寫作總要有些重點吧,加粗、斜體、刪除線開始派上用場了。這時你基本不會開啟 word 那樣的笨重軟體了。

如果你不幸是碼農:

\這是單行**``

//這是**段,四個空格或乙個製表符縮排

int i;

這是引用

以下是 mou 下面的效果,多麼漂亮:

mou 寫出的效果

正文一、markdown是什麼?

markdwon 是一種輕量級 標記語言,它以純文字形式(易讀、易寫、易更改)編寫文件,並最終以htlm格式發布。markdown也可以理解為將以 markdown語法編寫的語言轉換成html內容的工具。

二、markdown是誰創造的?

它是由 aaron swartz 和 [john gruber]( gruber/18550453?fr=aladdin) 共同設計, aaron swartz 就是那位(2023年1月11日)自殺,有著開掛一般人生經歷的程式設計師。 維基百科對他的介紹是:軟體工程師、作家、政治組織者、網際網路活動家、維基百科人。

他有著足以讓你跪拜的人生經歷。

14歲參與rss 1.0規格標準制訂。

2023年入讀史丹福大學,之後退學。

2023年建立 infogami,之後與reddit合併成為其合夥人。

2023年創立示進會(demand preogress),積極參與禁止網路盜版法案(sopa)活動,最終該提案被撤回。

2023年1月自殺身亡。

aaron swartz 大神**

三、為什麼要使用markdown?

它是易讀(看起來舒服?)、易寫(語法簡單)、易更改(純文字)。處處體現著極簡主義的影子。

相容html,可以轉換為html格式發布。

跨平台使用。

越來越多的**支援markdown.

更方便清晰的組織你的電子郵件。(markdown-here,airmail)。

擺脫word,txt!!!

四、markdown怎麼使用?

如果不算擴充套件,markdown的語法絕對簡單到讓你愛不釋手!

markdown語法分為如下幾大部分:

▸ 標題

▸ 段落

▸ 區塊引用

▸ **區塊

▸ 強調

▸ 列表

▸ 分割線

▸ 鏈結

▸ ▸ 反斜槓

▸ 符號

▸ **

▸ 流程圖

4.1 標題

示例效果:

效果圖2)使用 #,可以表示 1-6級 標題。

示例md**:

第二四級標題

第五級標題

第六級標題

示例效果:

效果圖4.2 段落

段落的前後要有空行,所謂的空行是指沒有文字內容。若想在段內強制換行的方式是使用兩個以上空格加上回車(引用中換行省略回車)

4.3 區塊引用

在段落的每行或者只在第一行使用符號 > ,還可使用多個巢狀引用,如:

示例md**:

區塊引用

巢狀引用

三巢狀引用

四巢狀引用

示例效果:

效果圖4.4**區塊

**區塊的建立是在每行加上4個空格或者乙個製表符(如同寫**一樣)。如普通段落:

示例md**:

fun main(args: array) 」)

println(「sum = $」)

println(「sum = $」)

printsum(237, 57)

printsum(234, 567, 8)

vars(1, 4, 6, 78, 0, 6, 9, 8)

val sumlambda: (int, int) -> int =

println(「sumlambda = $」)

// if (args.size < 2)

testfor()

val a: int = 1000

println(a === a)//true 值相等,物件位址相等

//經過了裝箱,建立了兩個不同的物件

val boxeda: int? = a

val anotherboxeda: int? = a

//雖然經過了裝箱,但是值是相等的,都是10000

println(boxeda === anotherboxeda) // false,值相等,物件位址不一樣

println(boxeda == anotherboxeda) // true,值相等

}示例效果:

效果圖注意⚠️:需要和普通段落之間存在空行!

4.5 強調

在強調內容兩側分別加上 *或者 -,如:

示例md**:

斜體 ,斜體

加粗粗體

示例效果:

效果圖4.6 列表 (有序,無序)

使用 . 、+、或- 標記無序列表,如:

示例md**:

示例效果:

效果圖**注意:標記後面最少有乙個_空格_或_製表符_。若不在引用區塊

中,必須和前方段落之間存在空行。**

示例md**:

第一項第二項第三項

第四項第五項

第六項

示例效果:

效果圖4.7 分割線

分割線最常使用就是三個或以上的 * , *****=還可以使用 - 和 _。

示例md**:

示例效果:

效果圖4.8鏈結

自動生成連線

示例效果:

效果圖自動生成連線

示例效果:

效果圖注意:上述的 [1]: 不出現在區塊中。

4.9

新增形式和鏈結相似,只需要在鏈結的基礎上前方加乙個 !號。

示例md**:

格式:github set up

4.10 反斜槓 『』

相當於反轉義作用。使符號成為普通符號。

4.11 符號 ``

起到標記作用,如標籤:

ctrl+a 、ctrl+c、ctrl+v

4.12 **

示例md**:

第一格表頭

第二格表頭

內容單元格 第一列第一格

內容單元格第二列第一格

內容單元格 第一列第二格 多加文字

內容單元格第二列第二格

內容單元格 第一列第三格 多加文字

內容單元格第二列第三格

內容單元格 第一列第四格 多加文字

內容單元格第二列第四格

示例效果:

效果圖4.12 流程圖

示例st=>start: start:>

io=>inputoutput: verification

op=>operation: your operation

cond=>condition: yes or no?

sub=>subroutine: your subroutine

e=>end

st->io->op->cond

cond(yes)->e

cond(no)->sub->io

六、嘗試一下markdown的使用!

學習使用Markdown最基礎的語法(編輯器通用)

使用 作為標題標誌,但是必須頂格使用,越少 越大,一般使用 作為小標題1234這樣列出來。語法格式 標題 標題 標題 效果 使用 作為引用,但完全可以發揮自己的想法,不止於引用,比如乙個問題然後答案用引用,或者名詞定義加上引用。語法格式 什麼是伯拉圖式愛情?柏拉圖式愛情,也稱為精神戀愛,以西方哲學家...

Markdown的基本語法

標題設定 讓字型變大,和word的標題意思一樣 在markdown當中設定標題,有兩種方式 第一種 通過在文字下方新增 和 他們分別表示一級標題和二級標題。第二種 在文字開頭加上 通過 數量表示幾級標題。一共只有1 6級標題,1級標題字型最大 塊注釋 blockquote 通過在文字開頭新增 表示塊...

Markdown新的語法

建立乙個自定義列表 如何建立乙個註腳 注釋也是必不可少的 katex數學公式 新的甘特圖功能,豐富你的文章 uml 圖表 flowchart流程圖 匯出與匯入 你好!這是你第一次使用markdown編輯器所展示的歡迎頁。如果你想學習如何使用markdown編輯器,可以仔細閱讀這篇文章,了解一下mar...