主頁 >  其他 > Markdown 入門及語法詳細指南 ★

Markdown 入門及語法詳細指南 ★

2021-08-04 07:31:46 其他

文章目錄

    • Markdown 簡介
    • Markdown 編輯工具
      • 1. 平臺集成
      • 2. 獨立軟體
      • 3. 插件拓展
    • Markdown 基本語法
      • 快捷鍵
      • 1. 標題
      • 2. 文本
      • 3. 串列
      • 4. 參考
      • 5. 代碼
      • 6. 鏈接與影像
      • 7. 表格
      • 8. 分隔線
      • 9.1 數學公式(擴展語法)
      • 9.2 圖表(擴展語法)
      • 轉義字符
      • 語法技巧
    • Markdown 功能拓展與語法支持
      • CSDN 語法支持
        • 1. 標題索引(目錄)
        • 2. 影像
        • 3. 注釋
        • 4. Flowchart 流程圖
      • GitHub 語法支持
        • 1. emoji表情
    • 結語

Markdown 簡介

Markdown 是一種輕量級標記語言,于 2004 由約翰·格魯伯(John Gruber)創建,Markdown 的目標是實作「易讀易寫」,一份使用 Markdown 格式撰寫的檔案應該可以直接以純文本發布,并且看起來不會像是由許多標簽或是格式指令所構成,

Markdown 通過少量簡單的語法 對文本進行樣式化 ,大多數情況下,Markdown 只是普通的文本,加上一些非字母字符,比如 #*- 等,Markdown 語法的種類很少,只對應 HTML 標記的一小部分,Markdown 的理念是,能讓檔案更容易讀、寫和隨意改,HTML 是一種發布的格式,Markdown 是一種書寫的格式,就這樣,Markdown 的格式語法只涵蓋純文本可以涵蓋的范圍,不在 Markdown 涵蓋范圍之內的標簽,都可以直接在檔案里面用 HTML 書寫,

Markdown不止是HTML的簡化版,更重要的是txt的升級版、Word的輕量版,是筆記的最佳載體,作為一種簡單的格式標記語言,不同于txt的無格式,不同于HTML的復雜標記,也不同于Word的復雜樣式調整,Markdown 通過簡單的幾個字符鍵入,就可以快捷的定義檔案的樣式,掌握 Markdown,你可以享受到簡潔之美、享受效率的提升,

使用 Markdown 的優點

  • 內容與格式分離,專注你的文字內容而不是排版樣式,安心寫作,
  • 輕松匯出 HTML、PDF 等多種格式的檔案和本身的 .md 源檔案,
  • 純文本內容,兼容所有的文本編輯器與文字處理軟體,
  • 可讀、直觀、學習成本低,

Markdown 的應用場景

  1. 在線閱覽

    • 在線文章(CSDN、博客園等在線平臺寫作發布的博文資訊,GitBook等發布的系列教程或筆記檔案)
    • 幫助檔案(README.md,GitHub等專案附帶的說明檔案,可在線預覽及本地閱讀)
  2. 本地文本編輯

    • 輕量編輯(少量的圖文排版和樣式調整,簡化編輯流程,用于簡潔的檔案輸出,對應的,不適合需要使用到大量內容及繁多樣式調整的復雜編輯!此時適宜使用Word等軟體進行處理)
    • 方便編輯與分發(基于純文本內容,不限制平臺、編輯器及其版本,同一檔案可在任意文本編輯器進行編輯,帶來輕便編輯體驗,而完成編輯的檔案可渲染輸出 HTML 頁面或者轉換為PDF等其他格式,方便在不同平臺間共享和閱讀)
    • 快速發布(一次編輯、任意匯入,對于集成 Markdown 編輯器的任意在線平臺,可將源檔案直接錄入,對內容不作較大改動的情況下進行快速發布,滿足檔案發布需求)

Markdown 的適用人群

  • 程式員、科研作業者(使用較多,技術檔案、技術博客等)
  • 博客博主(寫博文)
  • 作家(撰寫文章、書籍等)
  • 學生(輔助LaTeX 數學公式,筆記、論文等)
  • 其他(文字錄入、筆記整理等)


Markdown 編輯工具

參考文章:幾款主流好用的markdown編輯器介紹(CC 4.0 BY-SA 協議許可,參考部分原文作修改)

按照 Markdown 編輯器的使用環境,可以將它們歸納為三類,

  1. 平臺集成工具:各大在線博客、社區平臺自帶的寫作工具,比如 CSDN、博客園、GitHub 等,
  2. 獨立軟體類:下載到自己機器上使用的獨立產品,可以編輯本地檔案,比如 Mou、Typora 等(以下的 Markdown語法示例截圖中 使用的是 MarkdownPad、Typora及CSDN 編輯器顯示效果),
  3. 插件類:它自己本身是不能獨立使用的,可在你現有的編輯器中安裝,使你現有的編輯器具有Markdown的功能,比如 Atom、WebStorm、Sublime Text 等,

這三類軟體分別面向三類Markdown用戶,大家可以根據自己的需求來選擇使用,下面列舉了部分常用的 Markdown 編輯器:

1. 平臺集成

  • CSDN:https://www.csdn.net/
  • 博客園:https://www.cnblogs.com/
  • GitHub:https://github.com/
  • 更多:…

2. 獨立軟體

  • MarkdownPad,Markdown文本編輯器

    官網下載:http://markdownpad.com/

    支持系統:Windows

    MarkdownPad 被很多人稱贊為windows下最好用的Markdown編輯器之一,其支持鍵盤快捷鍵和工具列操作,支持即時HTML預覽及自動滾動至當前編輯位置、自定義配色方案、字體、大小和布局等,可以匯出HTML和PDF,其HTML輸出顯示中規中矩、比較穩定,但部分語法顯示需要些許設定,

  • Mou,Markdown文本編輯器

    官網下載:http://25.io/mou/

    支持系統:macOS

    Mou 是一個面向開發者的Markdown編輯器,其具有語法高亮、實時預覽、同步滾動、自動保存、自動補全、自定義主題和以CSS/HTML/PDF格式匯出檔案等特性,支持在編輯器內行內HTML代碼,并且對中文,日文和韓文的輸入非常友好,

  • Typora,Markdown文本編輯器

    官網下載:https://www.typora.io/

    支持系統:Windows、macOS、Linux

    Typora 是非常有名、非常好用的 Markdown編輯器,支持數學編輯、可與 Word 進行格式轉換、進行多種檔案格式轉換等,并且流暢度和反應速度都很快,Typora 同樣支持實時預覽,不同于左右兩個視窗的編輯器,它將「寫字」和「預覽」這兩件事情合并了,Typora的設計理念就是極致簡潔,編
    輯后直接渲染出效果以“即時預覽”,如果要修改已經寫好的Markdown標記可以切換到“源代碼模式”,

  • Mark Text,開源Markdown編輯器

    github下載:https://github.com/marktext/marktext

    支持系統:Windows、macOS、Linux

    Mark Text 是一個簡單而優雅的開源 Markdown編輯器,專注于速度和可用性,具有簡潔的外觀和流暢的運行,支持實時預覽、數學運算式 (KaTeX)、前端和表情符號、直接從剪貼板粘貼影像、HTML和PDF檔案輸出等多種功能,

  • more …

3. 插件拓展

  • Atom,跨平臺文本編輯器

    官網下載:https://atom.io/

    github下載:https://github.com/atom/atom

    漢化插件:https://github.com/chinakids/atom-simplified-chinese-menu/

    漢化方法:將下載好后的漢化包檔案夾解壓到 當前用戶目錄下的.atom\packages檔案夾中 并重啟Atom編輯器(windows系統路徑:C:\Users\用戶名\.atom\packages,linux系統路徑:~/.atom/packages),

    支持系統:Windows、macOS、Linux

    Atom 可以說是專門為程式員推出的一個文本編輯器,界面簡潔,支持實時預覽,Atom 由著名的GitHub平臺出品,是獨立的軟體,也支持插件方式,Atom功能非常多,除了Markdown同時支持CSS,HTML,JavaScript等網頁編程語言,還支持宏定義,自動分屏功能等,

  • Microsoft Visual Studio Code (VScode),跨平臺代碼編輯器

    官網下載:https://code.visualstudio.com/

    支持系統:Windows、macOS、Linux

    Visual Studio Code 是一個輕量級但功能強大的代碼編輯器,支持幾乎所有主流的開發語言的語法高亮、智能代碼補全、自定義熱鍵、括號匹配、代碼片段、代碼對比 Diff、GIT 等特性,支持插件擴展,在用VScode打開Markdown檔案后,點擊右上角第一個按鈕即可打開“預覽”實時查看,

  • Sublime Text,文本編輯器

    官網下載:http://www.sublimetext.com/

    支持系統:Windows、macOS、Linux

    Sublime Text 界面簡約大方,定位專業,功能強大,并具有良好的擴展功能,支持的編程語言有十幾種,并可通過第三方插件無限擴充,Sublime Text 默認不能實時預覽,可通過 Markdown Preview 插件 來實作該功能,

  • more …



Markdown 基本語法

Markdown 語法檔案:標準 Markdown 語法指南(John Gruber)


對于未被Markdown語法涵蓋的任何標記,只需使用HTML本身,沒有必要對其進行前綴或分隔,以表明您正在從Markdown切換到HTML,您只需使用這些標記即可,唯一的限制是塊級的HTML元素,如 <div>,<table>,<pre>, <p> 等標簽,必須用空行分隔周圍的內容,塊的開始和結束標記不應縮進制表符或空格,應注意,在 HTML 區塊標簽間的 Markdown 格式語法將不會被處理,

快捷鍵

功能快捷鍵參考(因各編輯器差異,具體鍵位視實際使用的編輯器設定為準)
標題Ctrl+1…6
加粗Ctrl+B
斜體Ctrl+I
有序串列Ctrl+O
無序串列Ctrl+U
任務串列Ctrl+C
參考Ctrl+Q
插入代碼Ctrl+K
插入鏈接Ctrl+L
插入圖片Ctrl+G
分割線Ctrl+R

1. 標題

要創建標題,只要在標題文本前添加 1~6個 # 字符即可,使用的 #數量 將決定標題的大小,總共六級標題,建議在#號后加一個 空格,這是最標準的 Markdown 語法,

# 標題1
## 標題2
### 標題3
#### 標題4
##### 標題5
###### 標題6

示例:標題

在這里插入圖片描述

標題索引(內容目錄):合理的創建標題,有助于目錄的生成,使用 [TOC] 以創建當前檔案目錄(由于編輯器的差異,對目錄創建的語法支持及語法規則應視實際使用的編輯器而定),

示例:標題索引(目錄)

Markdown標題_索引目錄

2. 文本

  • 強調文本

    可以使用粗體、斜體來表示強調,文本突出表示標記,

    2個星號 *下劃線 _ 包含一段文本就是粗體的語法,

    1個星號 *下劃線 _ 包含一段文本就是斜體的語法,

    2個波浪線 ~ 包含一段文本就是洗掉文本的語法,

    2個等號 = 包含一段文本就是標記文本的語法(擴展語法),

    粗體文本:**粗體文本**  __粗體文本__
    斜體文本:*斜體文本*    _斜體文本_
    洗掉文本:~~洗掉文本~~
    標記文本:==標記文本==
    

    示例:粗體、斜體、洗掉、標記

    粗體文本

    斜體文本

    洗掉文本

    標記文本

    Markdown文本_強調文本

  • 鍵盤文本

    使用 HTML 的 <kbd> 標簽,

    加粗:<kbd>Ctrl/Command</kbd> + <kbd>B</kbd>
    斜體:<kbd>Ctrl/Command</kbd> + <kbd>I</kbd>
    

    示例:鍵盤文本

    Markdown文本_鍵盤文本

3. 串列

Markdown的串列支持有序串列、無序串列以及特殊的任務串列,

  1. 有序串列:就是有順序的串列,使用 數字、英文句點 后面加一個 空格 作為串列標記,

    需要注意的是,用于標記串列的實際數字對Markdown輸出的HTML結果沒有任何影響,順序不等或相同的數字都將得到完全相同的HTML輸出,

    1. 有序串列1
    2. 有序串列2
    4. 有序串列3
    

    示例:有序串列(數字編號不影響最終輸出的HTML結果)

    Markdown串列_有序串列

    串列嵌套可使串列項包含多個段落,串列項中的 每個后續段落必須縮進 4個空格1個制表符,代碼塊需要縮進 8個空格2個制表符

    1. 有序串列1
       有序串列1的 段落
        > 有序串列1的 參考
            //有序串列1的 代碼塊
            use the printf() function;
    1. 有序串列2
    

    示例:有序串列中的的多個段落

    Markdown串列_有序串列2

    值得注意的是,以下示例中的撰寫會意外地觸發一個有序串列,為了避免這種情況,可以反斜線 \ 轉義句點

    2022. 北京冬季奧運會
    2022\. 北京冬季奧運會
    

    示例:為避免觸發有序串列,應對句點進行轉義

    Markdown串列_有序句點轉義

  2. 無序串列:就是串列不排序,使用 減號 -星號 *加號 + 作為串列標記,符號后須加上 空格

    無序串列有3種串列符,分別用于表示1級串列、2級串列、3級串列,行尾回車換行后會自動接續串列,再次按Tab會標記段落并更換串列符/再次按回車會清除串列符,

    - 1級串列
        * 2級串列
        * 2級串列
            + 3級串列
            + 3級串列
    - 1級串列
    - 1級串列
    

    示例:無序串列

    Markdown串列_無序串列

  3. 任務串列:非常實用,管理待辦已辦非常便利,

    在串列專案前面加 1個減號 -空格 、并緊跟 方括號 [ ] 作為待辦任務標記,使用 [x] 將任務標記為已完成,

    - [ ] 任務串列(待辦任務)
    - [x] 任務串列(完成任務)
    

    示例:任務串列

    • 任務串列(待辦任務)
    • 任務串列(完成任務)

    Markdown串列_任務串列


    MarkdownPad 任務串列不顯示:MarkdownPad 顯示設定——任務串列顯示

4. 參考

區塊參考是在段落開頭使用 右尖括號 > ,并緊跟一個 空格 來參考文本,也可再次添加 > 嵌套參考,

> 參考1
>> 參考2
>
> 參考1

示例:參考及其嵌套

Markdown參考

參考的區塊中也可以包含其它Markdown元素,包括標題、串列、代碼塊等,

> ## 標題
>
> 1. 有序串列1
> 2. 有序串列2
>
> - 無序串列
>     - 無序串列
>
> 代碼示例:
>
>     use the printf() function;

示例:參考及其它元素嵌套

Markdown參考_嵌套元素

5. 代碼

在代碼塊中,符號(&) 和尖括號(<和>) 會被自動轉換為HTML物體,這使得使用Markdown包含HTML源代碼變得非常容易——只需粘貼并縮進它,Markdown就可以對特殊字符自動轉義,減免了處理編碼特殊字符的麻煩,

  1. 代碼片 (行內代碼塊)

    引用代碼時,如果參考的陳述句只有一段,僅作為普通段落中的代碼,可使用 1個反引號 ` 將其包起來,反引號中的文本不會被格式化,

    Use the `printf()` function;
    

    示例:代碼片

    Markdown代碼片

  2. 代碼塊 (圍欄代碼塊)

    參考代碼時,如果參考的陳述句為多行,可在代碼行首縮進 4個空格1個制表符 (Tab) ,也可以使用 3個反引號 ` 置于代碼的首行和末行,

    示例:代碼塊

    Markdown代碼塊


    MarkdownPad 三個反引號對代碼塊無作用:MarkdownPad 顯示設定——三個反引號作用于代碼塊

    語法高亮:要將代碼或文本格式化為各自的不同塊,可使用 3個反引號 ` 包裹一段代碼,并在首行反引號后面指明 語言識別符號

    ```[語言識別符號]
      在這里插入代碼
    ```
    例如:
    ```javascript
      // An highlighted block
      var foo = "bar";
    ```
    

    示例:代碼塊 語法高亮

    Markdown代碼塊_語法高亮


    MarkdownPad 語法無高亮:MarkdownPad 顯示設定——語法高亮

6. 鏈接與影像

插入鏈接與插入圖片的語法很像,區別在一個 !

鏈接: [鏈接文字](URL地址 可選title屬性)
影像:![影像描述文字](URL地址 可選title屬性)

示例:鏈接、影像

Markdown鏈接與影像


Markdown沒有用于指定影像尺寸的語法,如果你需要的話,你可以使用普通的 <img> 標簽,

插入圖片的地址需要圖床,圖床工具用于上傳圖片獲取URL地址,

Markdown支持兩種鏈接樣式:行內鏈接參考鏈接,在這兩種樣式中,鏈接文字都是用 方括號 [] 來標記,鏈接和影像使用方式相同,

  1. 行內鏈接

    創建行內鏈接,將鏈接文字包含在 方括號 [] 中,并緊跟著 小括號 () ,在括號內,指定鏈接的URL,可選地,空格 后面跟著鏈接的 title屬性,用 雙引號(推薦)、單引號小括號 包圍起來,

    例如:

    This is [an example](http://example.com/) inline link.

    [This link](http://example.com/ “Title”) has title attribute.

    如果你參考的是同一路徑下的本地資源,可以使用相對路徑

    See my [About](/about/) page for details.

  2. 參考鏈接

    參考鏈接是在鏈接文字的括號后面再接上 第二組方括號,在其中填入用以 辨識鏈接的標簽

    This is [an example][1] reference-style link.

    然后,在檔案中的任何地方,都可以像這樣 在一行中定義鏈接標簽

    [1]: http://example.com/ “Optional Title Here”

    你可以將title屬性放在下一行,并為其使用額外的空格或制表符,使用更長的URL時看起來更好:

    [1]: http://example.com/longish/path/to/resource/here/…

    “Optional Title Here”

    辨識鏈接的標簽名 可由字母、數字、空格和標點符號組成,它們是 不區分大小寫 的,例如,以下這兩個鏈接是等價的:

    [link text][a]

    [link text][A]


    隱式鏈接名 允許你省略鏈接標簽的名稱,在這種情況下,鏈接文字本身 將用作名稱,只需在鏈接文字后面加上 一組空的方括號,你可以簡單地寫:

    [Baidu][]

    然后定義鏈接:

    [Baidu]: https://www.baidu.com/

    由于鏈接名稱可能包含空格,此快捷方式甚至 適用于鏈接文字中的多個單詞

    Visit [Baidu Products][] for more information.

    然后定義鏈接:

    [Baidu Products]: https://www.baidu.com/more/


    鏈接標簽定義可以放在Markdown檔案中的任何位置,一般它們被放在使用它們的每一段之后,但是如果你想的話,你可以把它們都放在檔案的末尾,就像腳注一樣,

    例如:Baidu, Alibaba and Tencent are all Chinese Internet companies.

    下面是一個 參考鏈接 的示例:

    [Baidu][1], [Alibaba][2] and [Tencent][3] are all Chinese Internet companies.

    [1]: https://www.baidu.com/ “Baidu”

    [2]: https://www.alibaba.com/ “Alibaba”

    [3]: https://www.tencent.com/ “Tencent”

    使用 隱式鏈接名 的方式,你可以撰寫:

    [Baidu][], [Alibaba][] and [Tencent][] are all Chinese Internet companies.

    [Baidu]: https://www.baidu.com/ “Baidu”

    [Alibaba]: https://www.alibaba.com/ “Alibaba”

    [Tencent]: https://www.tencent.com/ “Tencent”

    為了與以上參考鏈接進行比較,下面是使用 行內鏈接 撰寫的相同段落:

    [Baidu](https://www.baidu.com/ “Baidu”), [Alibaba](https://www.alibaba.com/ “Alibaba”) and [Tencent](https://www.tencent.com/ “Tencent”) are all Chinese Internet companies.

    參考式鏈接的要點并不是它們更容易撰寫,關鍵是,有了參考樣式的鏈接,可大大提高檔案的可讀性,使用Markdown的參考樣式鏈接,源檔案更類似于在瀏覽器中呈現的最終輸出結果,讓你可以把一些標記相關的元資料移到段落文字之外,你就可以增加鏈接而不讓文章的閱讀感被打斷,


自動鏈接

Markdown支持以比較簡短的自動鏈接形式來處理URL和電子郵件地址:只需用 尖括號 <>(推薦)環繞URL/電子郵件地址 或 直接書寫 其地址即可,Markdown 就會自動把它轉成鏈接,這意味著,如果你想 顯示URL或電子郵件地址的實際文本,并讓它成為可點擊的鏈接,你可以這樣做:

示例:直接書寫 或 使用尖括號包圍(推薦)以創建自動鏈接

http://example.com/

yourname@email.com

Markdown鏈接_自動鏈接


其它:腳注(擴展語法)

腳注的解釋自動追加到文末(腳注的語法支持及語法規則應視實際使用的編輯器而定),

示例:腳注

Markdown鏈接_腳注


自定義腳注:編輯器不支持時,可使用 HTML 上標標簽鏈接語法 以手動構建:

  1. 使用 HTML上標標簽 在檔案中定義腳注標記:<sup id="fnref1">[1](#fn1)</sup>
  2. 使用 ? 字符在檔案底部定義腳注內容的回傳標記:<b id="fn1">[?](#fnref1)</b>

Markdown鏈接_腳注-自定義

注意:為使多個腳注能夠跳轉腳注及回到鏈接,腳注編號應每組對應、#與跳轉id后面的值應相同,

7. 表格

Markdown 制作表格使用 豎線 | 來分隔不同的單元格,使用 橫線 - 來分隔表頭和其他行,

單元格的寬度可以不同,無需在列內準確對齊,標題行的每一列中必須至少有一個橫線 (推薦3個以上),

| 表頭 | 表頭 |
|  -  |  -  |
|單元格|單元格|

示例:一個簡單的表格是這么創建的

Markdown表格


列1列2
12
12

MarkdownPad 表格不顯示:MarkdownPad 顯示設定——表格顯示

對齊方式:在標題行中橫線的左側、右側或兩側加入冒號 : ,以靠左、靠右或居中對齊列中的文本,

使用 :---: 設定內容和標題 居中對齊
使用 :---  設定內容和標題 居左對齊
使用  ---: 設定內容和標題 居右對齊
例如:
|第一列       |      第二列|第三列      |
|:----------:|----------:|:----------|
|第一列文本居中|第二列文本居右|第二列文本居左|

示例:表格對齊

Markdown表格內容對齊


第一列第二列第三列
第一列文本居中第二列文本居右第三列文本居左

8. 分隔線

在一行中使用 3個以上 連字符 星號 *下劃線 _ ,行內不能有其他字符,但可以在其中插入空格,

示例:分隔線

Markdown分隔線

9.1 數學公式(擴展語法)

LaTeX 數學公式 語法串列查詢https://katex.org/docs/supported.html

LaTeX 數學公式 在線編輯工具https://latex.codecogs.com/eqneditor/editor.php


現已有不同的Markdown工具集成并豐富了更多的功能,如較為復雜的數學公式、流程圖、時序圖等,雖有多種工具的支持呈現,但更為復雜的功能或許專業的圖形界面工具會更為方便、更有效率,選擇適合自己的書寫方法時,語法支持及語法規則還應視實際使用的編輯器而定,

數學公式:當你需要在編輯器中插入數學公式時,可以使用 2個美元符 $ 包裹 TeX 或 LaTeX 格式的數學公式來實作,

示例:數學公式

Markdown數學公式

上標和下標:上標使用符號 ~ 包圍、下標使用符號 ^ 包圍,編輯器不支持時,可分別使用 HTML 標簽 <sup>(superscript) 和 <sub>(subscript) 替代,

示例:上標和下標

210,H2O

Markdown數學公式_上標和下標


使用 HTML 標簽

210,H2O

Markdown數學公式_上標和下標-標簽

9.2 圖表(擴展語法)

  • Mermaid 流程圖

    Mermaid 流程圖 語法檔案:https://mermaid-js.github.io/mermaid/#/flowchart

    Markdown圖表_mermaid流程圖

  • Mermaid 時序圖

    Mermaid 時序圖 語法檔案:https://mermaid-js.github.io/mermaid/#/sequenceDiagram

    Markdown圖表_mermaid時序圖

  • Mermaid 甘特圖

    Mermaid 甘特圖 語法檔案:https://mermaid-js.github.io/mermaid/#/gantt

    Markdown圖表_mermaid甘特圖

  • 查看 Mermaid 更多圖表:https://mermaid-js.github.io/mermaid/#/

轉義字符

Markdown 允許使用 反斜線 \ 轉義 來插入一些在語法中有特殊意義的符號,以使其輸入為普通字符,

Markdown 為下列字符提供反斜線轉義:

\ 反斜線

` 反引號

* 星號

_ 下劃線

{} 花括號

[] 方括號

() 小括號

# 井號

+ 加號

- 減號(連字符)

. 英文句點

! 感嘆號

語法技巧

  1. 出現帶有換行的段落、不同的 Markdown 語法時,盡量在換行后再多添加一個空行,使用空行將多個段落、不同的語法內容隔開,使得最終輸出結果最大兼容不同的 Markdown編輯器、同步于編輯時的源檔案排版結構,未添加空行將出現部分編輯器略過換行、將多個段落文字連續滿行顯示,而緊湊的語法內容未得到正常格式化使得語法失效或混亂,

  2. 使用以上 Markdown 基本語法說明中給出“(推薦)”標示的選項,如 “自動鏈接” 中推薦使用 尖括號 <> 將鏈接地址包圍,可最大兼容生成鏈接,而直接書寫鏈接地址時部分編輯器未能生成自動鏈接,

Markdown 基本語法至此已經結束了,本檔案全文即為 Markdown基本語法 本地預編輯 加在線匯入實踐,僅做了替換影像原URL地址并審查全文無誤后直接發布,



Markdown 功能拓展與語法支持

基于以上 Markdown基本語法的 第三方增強語法支持,以下僅作舉例說明,

CSDN 語法支持

1. 標題索引(目錄)

使用 @[TOC](自定義目錄標題) 創建目錄

Markdown-CSDN-標題_索引目錄

2. 影像

在影像URL地址后面拼接如下屬性:

帶尺寸的圖片:空格=寬x高

居中的圖片:#pic_center

右對齊的圖片:#pic_right

Markdown-CSDN-影像

CSDN撰寫的檔案在其它編輯器打開時,其中設定過對齊屬性的影像可能顯示失敗,須恢復為源鏈接:

Markdown-CSDN-影像_URL

為適配兼容其它 Markdown編輯器,可使用HTML <img> 等標簽:

<div align="center">
    <img src="https://img-blog.csdnimg.cn/20210405103436678.png"/>
</div>

3. 注釋

相當于 HTML <abbr> 標簽,正文所有相關詞自動匹配:

Markdown-CSDN-注釋_縮寫

4. Flowchart 流程圖

Flowchart 流程圖 語法檔案:http://flowchart.js.org/

Markdown-CSDN-圖表_Flowchart流程圖


GitHub 語法支持

1. emoji表情

通過鍵入 :EMOJICODE: 可在您的寫作中添加表情符號,鍵入 : 將顯示建議的表情符號串列,串列將在您鍵入時進行過濾,因此一旦找到所需表情符號,請按 Tab 或 Enter 鍵以填寫選中的結果,

表情符號支持串列 表情備忘單:https://github.com/ikatyang/emoji-cheat-sheet/blob/master/README.md

@cat :+1: 這個 PR 看起來很棒 - 可以合并了! :laughing:

Markdown-GitHub-emoji


結語

一頓操作哦吼吼,這篇 Markdown語法指南 作為我的開篇博客,希望能夠幫助到有需要的朋友哦!這篇檔案不僅可以有效幫助到剛入門 Markdown 的小白 👍,也希望對 Markdown 已有了解的高玩提供更多幫助 😆 ,文中如有疏漏還請大佬指出改正,后續會繼續補充完善噠,

轉載請註明出處,本文鏈接:https://www.uj5u.com/qita/291621.html

標籤:其他

上一篇:asp.net961-個人博客系統#畢業設計

下一篇:資料結構OJ題——移除鏈表元素

標籤雲
其他(157675) Python(38076) JavaScript(25376) Java(17977) C(15215) 區塊鏈(8255) C#(7972) AI(7469) 爪哇(7425) MySQL(7132) html(6777) 基礎類(6313) sql(6102) 熊猫(6058) PHP(5869) 数组(5741) R(5409) Linux(5327) 反应(5209) 腳本語言(PerlPython)(5129) 非技術區(4971) Android(4554) 数据框(4311) css(4259) 节点.js(4032) C語言(3288) json(3245) 列表(3129) 扑(3119) C++語言(3117) 安卓(2998) 打字稿(2995) VBA(2789) Java相關(2746) 疑難問題(2699) 细绳(2522) 單片機工控(2479) iOS(2429) ASP.NET(2402) MongoDB(2323) 麻木的(2285) 正则表达式(2254) 字典(2211) 循环(2198) 迅速(2185) 擅长(2169) 镖(2155) 功能(1967) .NET技术(1958) Web開發(1951) python-3.x(1918) HtmlCss(1915) 弹簧靴(1913) C++(1909) xml(1889) PostgreSQL(1872) .NETCore(1853) 谷歌表格(1846) Unity3D(1843) for循环(1842)

熱門瀏覽
  • 網閘典型架構簡述

    網閘架構一般分為兩種:三主機的三系統架構網閘和雙主機的2+1架構網閘。 三主機架構分別為內端機、外端機和仲裁機。三機無論從軟體和硬體上均各自獨立。首先從硬體上來看,三機都用各自獨立的主板、記憶體及存盤設備。從軟體上來看,三機有各自獨立的作業系統。這樣能達到完全的三機獨立。對于“2+1”系統,“2”分為 ......

    uj5u.com 2020-09-10 02:00:44 more
  • 如何從xshell上傳檔案到centos linux虛擬機里

    如何從xshell上傳檔案到centos linux虛擬機里及:虛擬機CentOs下執行 yum -y install lrzsz命令,出現錯誤:鏡像無法找到軟體包 前言 一、安裝lrzsz步驟 二、上傳檔案 三、遇到的問題及解決方案 總結 前言 提示:其實很簡單,往虛擬機上安裝一個上傳檔案的工具 ......

    uj5u.com 2020-09-10 02:00:47 more
  • 一、SQLMAP入門

    一、SQLMAP入門 1、判斷是否存在注入 sqlmap.py -u 網址/id=1 id=1不可缺少。當注入點后面的引數大于兩個時。需要加雙引號, sqlmap.py -u "網址/id=1&uid=1" 2、判斷文本中的請求是否存在注入 從文本中加載http請求,SQLMAP可以從一個文本檔案中 ......

    uj5u.com 2020-09-10 02:00:50 more
  • Metasploit 簡單使用教程

    metasploit 簡單使用教程 浩先生, 2020-08-28 16:18:25 分類專欄: kail 網路安全 linux 文章標簽: linux資訊安全 編輯 著作權 metasploit 使用教程 前言 一、Metasploit是什么? 二、準備作業 三、具體步驟 前言 Msfconsole ......

    uj5u.com 2020-09-10 02:00:53 more
  • 游戲逆向之驅動層與用戶層通訊

    驅動層代碼: #pragma once #include <ntifs.h> #define add_code CTL_CODE(FILE_DEVICE_UNKNOWN,0x800,METHOD_BUFFERED,FILE_ANY_ACCESS) /* 更多游戲逆向視頻www.yxfzedu.com ......

    uj5u.com 2020-09-10 02:00:56 more
  • 北斗電力時鐘(北斗授時服務器)讓網路資料更精準

    北斗電力時鐘(北斗授時服務器)讓網路資料更精準 北斗電力時鐘(北斗授時服務器)讓網路資料更精準 京準電子科技官微——ahjzsz 近幾年,資訊技術的得了快速發展,互聯網在逐漸普及,其在人們生活和生產中都得到了廣泛應用,并且取得了不錯的應用效果。計算機網路資訊在電力系統中的應用,一方面使電力系統的運行 ......

    uj5u.com 2020-09-10 02:01:03 more
  • 【CTF】CTFHub 技能樹 彩蛋 writeup

    ?碎碎念 CTFHub:https://www.ctfhub.com/ 筆者入門CTF時時剛開始刷的是bugku的舊平臺,后來才有了CTFHub。 感覺不論是網頁UI設計,還是題目質量,賽事跟蹤,工具軟體都做得很不錯。 而且因為獨到的金幣制度的確讓人有一種想去刷題賺金幣的感覺。 個人還是非常喜歡這個 ......

    uj5u.com 2020-09-10 02:04:05 more
  • 02windows基礎操作

    我學到了一下幾點 Windows系統目錄結構與滲透的作用 常見Windows的服務詳解 Windows埠詳解 常用的Windows注冊表詳解 hacker DOS命令詳解(net user / type /md /rd/ dir /cd /net use copy、批處理 等) 利用dos命令制作 ......

    uj5u.com 2020-09-10 02:04:18 more
  • 03.Linux基礎操作

    我學到了以下幾點 01Linux系統介紹02系統安裝,密碼啊破解03Linux常用命令04LAMP 01LINUX windows: win03 8 12 16 19 配置不繁瑣 Linux:redhat,centos(紅帽社區版),Ubuntu server,suse unix:金融機構,證券,銀 ......

    uj5u.com 2020-09-10 02:04:30 more
  • 05HTML

    01HTML介紹 02頭部標簽講解03基礎標簽講解04表單標簽講解 HTML前段語言 js1.了解代碼2.根據代碼 懂得挖掘漏洞 (POST注入/XSS漏洞上傳)3.黑帽seo 白帽seo 客戶網站被黑帽植入劫持代碼如何處理4.熟悉html表單 <html><head><title>TDK標題,描述 ......

    uj5u.com 2020-09-10 02:04:36 more
最新发布
  • 2023年最新微信小程式抓包教程

    01 開門見山 隔一個月發一篇文章,不過分。 首先回顧一下《微信系結手機號資料庫被脫庫事件》,我也是第一時間得知了這個訊息,然后跟蹤了整件事情的經過。下面是這起事件的相關截圖以及近日流出的一萬條資料樣本: 個人認為這件事也沒什么,還不如關注一下之前45億快遞資料查詢渠道疑似在近日復活的訊息。 訊息是 ......

    uj5u.com 2023-04-20 08:48:24 more
  • web3 產品介紹:metamask 錢包 使用最多的瀏覽器插件錢包

    Metamask錢包是一種基于區塊鏈技術的數字貨幣錢包,它允許用戶在安全、便捷的環境下管理自己的加密資產。Metamask錢包是以太坊生態系統中最流行的錢包之一,它具有易于使用、安全性高和功能強大等優點。 本文將詳細介紹Metamask錢包的功能和使用方法。 一、 Metamask錢包的功能 數字資 ......

    uj5u.com 2023-04-20 08:47:46 more
  • vulnhub_Earth

    前言 靶機地址->>>vulnhub_Earth 攻擊機ip:192.168.20.121 靶機ip:192.168.20.122 參考文章 https://www.cnblogs.com/Jing-X/archive/2022/04/03/16097695.html https://www.cnb ......

    uj5u.com 2023-04-20 07:46:20 more
  • 從4k到42k,軟體測驗工程師的漲薪史,給我看哭了

    清明節一過,盲猜大家已經無心上班,在數著日子準備過五一,但一想到銀行卡里的余額……瞬間心情就不美麗了。最近,2023年高校畢業生就業調查顯示,本科畢業月平均起薪為5825元。調查一出,便有很多同學表示自己又被平均了。看著這一資料,不免讓人想到前不久中國青年報的一項調查:近六成大學生認為畢業10年內會 ......

    uj5u.com 2023-04-20 07:44:00 more
  • 最新版本 Stable Diffusion 開源 AI 繪畫工具之中文自動提詞篇

    🎈 標簽生成器 由于輸入正向提示詞 prompt 和反向提示詞 negative prompt 都是使用英文,所以對學習母語的我們非常不友好 使用網址:https://tinygeeker.github.io/p/ai-prompt-generator 這個網址是為了讓大家在使用 AI 繪畫的時候 ......

    uj5u.com 2023-04-20 07:43:36 more
  • 漫談前端自動化測驗演進之路及測驗工具分析

    隨著前端技術的不斷發展和應用程式的日益復雜,前端自動化測驗也在不斷演進。隨著 Web 應用程式變得越來越復雜,自動化測驗的需求也越來越高。如今,自動化測驗已經成為 Web 應用程式開發程序中不可或缺的一部分,它們可以幫助開發人員更快地發現和修復錯誤,提高應用程式的性能和可靠性。 ......

    uj5u.com 2023-04-20 07:43:16 more
  • CANN開發實踐:4個DVPP記憶體問題的典型案例解讀

    摘要:由于DVPP媒體資料處理功能對存放輸入、輸出資料的記憶體有更高的要求(例如,記憶體首地址128位元組對齊),因此需呼叫專用的記憶體申請介面,那么本期就分享幾個關于DVPP記憶體問題的典型案例,并給出原因分析及解決方法。 本文分享自華為云社區《FAQ_DVPP記憶體問題案例》,作者:昇騰CANN。 DVPP ......

    uj5u.com 2023-04-20 07:43:03 more
  • msf學習

    msf學習 以kali自帶的msf為例 一、msf核心模塊與功能 msf模塊都放在/usr/share/metasploit-framework/modules目錄下 1、auxiliary 輔助模塊,輔助滲透(埠掃描、登錄密碼爆破、漏洞驗證等) 2、encoders 編碼器模塊,主要包含各種編碼 ......

    uj5u.com 2023-04-20 07:42:59 more
  • Halcon軟體安裝與界面簡介

    1. 下載Halcon17版本到到本地 2. 雙擊安裝包后 3. 步驟如下 1.2 Halcon軟體安裝 界面分為四大塊 1. Halcon的五個助手 1) 影像采集助手:與相機連接,設定相機引數,采集影像 2) 標定助手:九點標定或是其它的標定,生成標定檔案及內參外參,可以將像素單位轉換為長度單位 ......

    uj5u.com 2023-04-20 07:42:17 more
  • 在MacOS下使用Unity3D開發游戲

    第一次發博客,先發一下我的游戲開發環境吧。 去年2月份買了一臺MacBookPro2021 M1pro(以下簡稱mbp),這一年來一直在用mbp開發游戲。我大致分享一下我的開發工具以及使用體驗。 1、Unity 官網鏈接: https://unity.cn/releases 我一般使用的Apple ......

    uj5u.com 2023-04-20 07:40:19 more