日韩性视频-久久久蜜桃-www中文字幕-在线中文字幕av-亚洲欧美一区二区三区四区-撸久久-香蕉视频一区-久久无码精品丰满人妻-国产高潮av-激情福利社-日韩av网址大全-国产精品久久999-日本五十路在线-性欧美在线-久久99精品波多结衣一区-男女午夜免费视频-黑人极品ⅴideos精品欧美棵-人人妻人人澡人人爽精品欧美一区-日韩一区在线看-欧美a级在线免费观看

歡迎訪問 生活随笔!

生活随笔

當前位置: 首頁 > 编程资源 > 编程问答 >内容正文

编程问答

Markdown 入门及语法详细指南 ★

發布時間:2024/3/12 编程问答 22 豆豆
生活随笔 收集整理的這篇文章主要介紹了 Markdown 入门及语法详细指南 ★ 小編覺得挺不錯的,現在分享給大家,幫大家做個參考.

文章目錄

    • 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表情
        • 2. @提及人員和團隊
    • 結語

Markdown 簡介

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

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

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

使用 Markdown 的優點

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

Markdown 的應用場景

  • 在線閱讀

    • 文章資訊(集成支持 Markdown 寫作工具的在線平臺,如在 CSDN、博客園等平臺寫作發布的博文資訊,GitBook等發布的系列文檔)
    • 幫助文檔(README.md,GitHub等項目附帶的說明文檔,可在線預覽及本地閱讀)
  • 文本編輯

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

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


    Markdown 編輯工具

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

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

  • 平臺集成工具:各大在線博客、社區平臺自帶的寫作工具,比如 CSDN、博客園、GitHub 等。
  • 獨立軟件類:下載到自己機器上使用的獨立產品,可以編輯本地文件,比如 Mou、Typora 等(以下的 Markdown語法示例截圖中 使用的是 MarkdownPad、Typora及CSDN 編輯器顯示效果)。
  • 插件類:它自己本身是不能獨立使用的,可在你現有的編輯器中安裝,使你現有的編輯器具有Markdown的功能,比如 Atom、WebStorm、Sublime Text 等。
  • 關于以上 Markdown 編輯器的不同使用場景,大家可以根據自己的需求來選擇使用。下面列舉了部分常用的 Markdown 編輯器:

    1. 平臺集成

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

    2. 獨立軟件

    • MarkdownPad,Markdown文本編輯器

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

      支持系統:Windows

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

    • Mou,Markdown文本編輯器

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

      支持系統:macOS

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

    • Typora,Markdown文本編輯器

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

      支持系統:Windows、macOS、Linux

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

    • more …

    3. 插件拓展

    • Atom,跨平臺文本編輯器

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

      支持系統:Windows、macOS、Linux

      官網下載: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)。

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

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

      支持系統:Windows、macOS、Linux

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

    • Sublime Text,文本編輯器

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

      支持系統:Windows、macOS、Linux

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

    • 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] 以創建當前文檔目錄(由于編輯器的差異,對目錄創建的語法支持及語法規則應視實際使用的編輯器而定)。

    示例:標題索引(目錄)

    2. 文本

    • 強調文本

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

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

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

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

      2個等號 = 包含一段文本就是標記文本的語法(未生效時可使用 HTML 標簽 <mark> 替代)。

      粗體文本:**粗體文本** __粗體文本__ 斜體文本:*斜體文本* _斜體文本_ 刪除文本:~~刪除文本~~ 標記文本:==標記文本==

      示例:粗體、斜體、刪除、標記

      粗體文本

      斜體文本

      刪除文本

      標記文本

    • 鍵盤文本

      使用 HTML 的 <kbd> 標簽。

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

      示例:鍵盤文本

    3. 列表

    Markdown的列表支持有序列表、無序列表以及特殊的任務列表。

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

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

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

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

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

    1. 有序列表1有序列表1的 段落> 有序列表1的 引用//有序列表1的 代碼塊use the printf() function; 1. 有序列表2

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

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

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

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

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

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

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

    示例:無序列表

  • 任務列表:非常實用,管理待辦已辦非常便利。

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

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

    示例:任務列表

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

  • 4. 引用

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

    > 引用1 >> 引用2 > > 引用1

    示例:引用及其嵌套

    引用的區塊中也可以包含其它Markdown元素,包括標題、列表、代碼塊等。

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

    示例:引用及其它元素嵌套

    5. 代碼

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

  • 代碼片 (內聯代碼塊)

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

    Use the `printf()` function;

    示例:代碼片

  • 代碼塊 (圍欄代碼塊)

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

    示例:代碼塊

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

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

    示例:代碼塊 語法高亮

  • 6. 鏈接與圖像

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

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

    示例:鏈接、圖像


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

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

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

  • 內聯鏈接

    創建內聯鏈接,將鏈接文字包含在 方括號 [] 中,并緊跟著 小括號 () 。在括號內,指定鏈接的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.

  • 引用鏈接

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

    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


    其它:腳注(擴展語法)

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

    示例:腳注


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

  • 使用 HTML上標標簽 在文檔中定義腳注標記:<sup id="fnref1">[1](#fn1)</sup>
  • 使用 ? 字符在文檔底部定義腳注內容的返回標記:<b id="fn1">[?](#fnref1)</b>
  • 注意:為使多個腳注能夠跳轉腳注及回到鏈接,腳注編號應每組對應、#與跳轉id后面的值應相同。

    7. 表格

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

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

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

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


    列1列2
    12
    12

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

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

    示例:表格對齊


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

    8. 分隔線

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

    示例:分隔線

    9.1 數學公式(擴展語法)

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

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


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

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

    示例:數學公式

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

    示例:上標和下標

    210,H2O


    使用 HTML 標簽方式:

    210,H2O

    9.2 圖表(擴展語法)

    • Mermaid 流程圖

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

    • Mermaid 時序圖

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

    • Mermaid 甘特圖

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

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

    轉義字符

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

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

    \ 反斜線

    ` 反引號

    * 星號

    _ 下劃線

    {} 花括號

    [] 方括號

    () 小括號

    # 井號

    + 加號

    - 減號(連字符)

    . 英文句點

    ! 感嘆號

    語法技巧

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

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

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



    Markdown 功能拓展與語法支持

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

    CSDN 語法支持

    1. 標題索引(目錄)

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

    2. 圖像

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

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

    居中的圖片:#pic_center

    右對齊的圖片:#pic_right

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

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

    <p style="text-align: center;"><img src="https://img-blog.csdnimg.cn/20210405103436678.png"/> </p>

    3. 注釋

    使用 方括號 [] 包圍關鍵詞,前面的 星號 * 使正文匹配所有相關詞,相當于 HTML <abbr> 標簽:

    4. Flowchart 流程圖

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


    GitHub 語法支持

    1. emoji表情

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

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

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

    2. @提及人員和團隊

    鍵入 @ 加上 用戶名或團隊名稱。這將觸發通知并提醒他們注意對話。如果在編輯的評論中提及某人的用戶名或團隊名稱,該用戶也會收到通知。當您提及父團隊時,其子團隊的成員也會收到通知,這簡化了與多個人員團隊的溝通。

    鍵入 @ 符號將顯示項目中的人員或團隊列表。列表會在您鍵入時進行過濾。提及團隊時,輸入 @組織/團隊名稱,該團隊的所有成員將收到關注對話的提醒。

    自動填寫結果僅限于倉庫協作者和該線程上的任何其他參與者。


    結語

    耐心的編輯與排版很辛苦,但對于讀者的友好閱讀是值得的。希望這篇 Markdown 語法指南能夠幫助到有需要的朋友哦!這篇文檔不僅可以有效幫助到剛入門 Markdown 的小白 👍,也希望對 Markdown 已有了解的朋友提供其它補充 😆 。文中如有疏漏還請大佬指出改正,后續會繼續補充完善噠。

    總結

    以上是生活随笔為你收集整理的Markdown 入门及语法详细指南 ★的全部內容,希望文章能夠幫你解決所遇到的問題。

    如果覺得生活随笔網站內容還不錯,歡迎將生活随笔推薦給好友。