MarkDown語法


什么是MarkDown

123
  markdown是一種輕量級標記語言,它簡潔語法,寫文章更加輕松,易於閱讀,markdown具有美觀的排版,可內聯HTML,可擴展(eimoji表情,自定義樣式設計,可轉為PDF,World等格式),可書寫數學表達式,邏輯圖,可插入圖片,鏈接等

MarkDown的優點

  • 專注你的文字內容而不是排版樣式,安心寫作。
  • 輕松的導出 HTML、PDF 和本身的 .md 文件。
  • 純文本內容,兼容所有的文本編輯器與字處理軟件。
  • 隨時修改你的文章版本,不必像字處理軟件生成若干文件版本導致混亂。
  • 可讀、直觀、學習成本低。

We believe that writing is about content, about what you want to say – not about fancy formatting.
  我們堅信寫作寫的是內容,所思所想,而不是花樣格式。
— Ulysses for Mac

MarkDown在線編輯器

  此編輯器未曾留下姓名大佬基於開源項目mavonEditor開發,擴展了HTML復制、html文件導出、md文件導出等功能,戳這里https://markdowneditor.cn,這個編輯器放到文章里是為了方便讀者在閱讀文章時可以實際操作,更快的上手markdown

MarkDown語法篇

注意 markdown中涉及的符號均為半角!!!
語法中會有空格和空行,書寫出現問題時,查看格式中是否有空格或空行

標題

  由於設置標題會影響排版,所以就不寫例子了。如果想看具體樣式可以跳轉到markdown-editor

    # 一級標題
    ## 二級標題
    ### 三級標題
    #### 四級標題
    ##### 五級標題
    ###### 六級標題  <!--最多6級標題-->

    `#`要和標題空一格

縮進

 &emsp; 全角
 &ensp; 半角

換行

  在行末空格加回車或者Html的br標簽

對齊

  markdown不支持對齊,但markdown支持html標簽和css樣式,可以使用html+css樣式驚醒對齊,一般對齊如下

  <center>居中</center> or <p style="text-align: center">居中</p>
  <p align="right">右對齊</p> or <p style="text-align: right">右對齊</p>
  <p align="left">左對齊</p> or <p style="text-align: left">左對齊</p>

字體

粗體

  **粗體文字**
  ***加粗體***

斜體

  _斜體_
  是半角下划線哦!

刪除線

  ~~刪除線~~

下划線

  ++下划線++

背景高亮

  ==背景高亮==

鏈接

行內鏈接

  [鏈接描述](鏈接網址)

  舉個栗子: 博客園

標注式鏈接

  最喜歡逛[博客園][1]啦~~

  [1]:https://www.cnblogs.com
 

冒號后不要有空格, 標注文字與被標注文字空一行,避免解析錯誤

最喜歡逛博客園啦~~

錨點鏈接

錨點鏈接其實就是HTML的a鏈接,錨點跳轉點就是#+元素id

  [我是錨點](#index)
  <p id="index">我是錨點跳轉落點</p>

我是錨點

我是錨點跳轉落點

自動鏈接

  Marndown可將<>內的網址或電子郵箱轉化成HTML的a鏈接

  <鏈接網址>

博客園在右邊https://www.cnblogs.com

插入圖片

  ![圖片加載失敗顯示的圖片描述](圖片地址)

123

分割線

  1. ***
  2. * * *
  3. ****
  4. - - -
  5. ---

  方式1


  方式2


  方式3


  方式4


  方式5


目錄

  markdown會將大、小標題匯總成一個目錄,前提是聲明目錄的命令


 [toc]

舉個栗子:

點擊這里

列表

有序列表

  編號. 內容

  比如: 
    1. 吃飯
    2. 睡覺
    3. 打豆豆

舉個栗子

  1. 吃飯
  2. 睡覺
  3. 打豆豆

無序列表

  * 內容 or - 內容 or + 內容

  比如:
   * 吃飯 or
   - 睡覺 or
   + 打豆豆

舉個栗子

  • 吃飯
  • 睡覺
  • 打豆豆

任務列表

 - [x] 已完成狀態
 - [ ] 未完成狀態

  博客園似乎沒有顯示任務列表樣式,可以在markdown-editor中或其他markdown編輯器查看樣式。

代碼塊

  代碼是寫程序必不可少的,markdown為了讓代碼正常書寫而不會出現解析問題,提供了代碼塊功能,語法是使用上下共6個反引號,代碼書寫在反引號之間

常規代碼塊

  \`\`\`
    我是代碼塊
  \`\`\`

  由於代碼塊不能支持嵌套所以,這里問了演示,我就用轉義字符轉義,防止解析出現奇怪的問題

Java代碼

戳我查看代碼
  public class User {
    private String userName;
    private int age;

    public User(String name, int age) {
       this.userName = name;
       this.age = age;
    }

    public String toString() {
      return `User = { userName:' + userName + ', age: ' + age + '}';
    }
  }

JavaScript代碼

戳我查看代碼
  class User {
    constructor(options) {
       this.userName = options.name;
       this.age = options.age;
    }
  }


行內代碼塊

  一般文字`我是行內代碼塊`一般文字

舉個栗子
  vite可通過yarn create vite app即可安裝

引用

  > 在這里寫引入的內容

  >后面空一個

舉個栗子

科學是人們生活中最重要、最美好和最需要的東西。

——— 契訶夫

表格

  markdown通過簡單的語法就可以寫出表格,當然,HTML方式也是可以寫,只是比較麻煩

  |字段1|字段2|字段三|
  |:-:|:-|-:|
  |居中|左對齊|右對齊|

 `|`是shift+回車上方的按鍵 

  舉個栗子

字段1 字段2 字段三
居中 左對齊 右對齊

角標

上角標

  語法

  2^10^

栗子: 210

下角標

  log~2~8

栗子: log28

折疊塊

  <details>
    <summary>戳我顯示隱藏內容</summary>

    這里寫折疊的內容
  </details>

戳我顯示隱藏內容
這里寫折疊的內容

注腳

  注腳

  HTML是 超文本標記語言[^1]

  [^1]:`HTML全稱: HyperText Markup Language`
  !!空一行!!
  [^2]:`HTML全稱: HyperText Markup Language`

舉個栗子

HTML是 超文本標記語言[1][2][3]

特殊字符對照表

戳我顯示對照表
特殊字符 描述 字符代碼
  空格符 &nbsp;
& 邏輯與 &amp;
< 小於號 &lt;
> 大於號 &gt;
¥ 人民幣 &yen;
± 正負號 &plusmn;
× 乘號 &times;
÷ 除號 &divide
© 版權符號 &copy;
® 注冊商標符號 &reg;
°C 攝氏度 &deg;C
« 雙小於號 &laquo;
» 雙大於號 &raquo;
² 平方 &sup2;
³ 立方 &sup3;
半角空格 &ensp;
全角 &emsp;
" 雙引號 &quot;
' 單引號 &apos;
¯ 上划線 &macr;
£ &pound;
大於等於 &ge;
小於等於 l&e;
三橫線 &equiv;
約等於 asymp;
¼ 四分之一 &frac14;
½ 二分之一 &frac12;
¾ 三分之四 &frac34;
五分之二 &frac25;
千分號 &permil;
ƒ 函數符號 &fnof;
角符號 &ang;
無窮 &infin;
積分 &int;
π π &pi;
回車 &crarr;
¿ 倒問號 &iquest;
TM &trade;
愛心 &hearts;
特殊符號 &lceil;
特殊符號 &rceil;
特殊符號 &lfloor;
特殊符號 &rfloor;
Ω 數學符號 &Omega;
β 數學符號 &beta;
Σ 數學符號 &Sigma;
α 數學符號 &alpha;
求和 &sum;
根號 &radic;
左箭頭 &larr;
右箭頭 &rarr;
上箭頭 &uarr;
下箭頭 &darr;
左箭頭 &lArr;
右箭頭 &rArr;
上箭頭 &uArr;
下箭頭 &dArr;

其他字符請參考w3cSchool的HTML ISO-8859-1 參考手冊


  語法偏多,但很多都是多次使用就可以記住的,大家可以按照使用頻率來對語法分層掌握,先掌握基礎的標題,鏈接,圖片,列表,然后學習復雜的表格,文字排版,代碼塊,錨點,公式等,特殊字符查表即可,無需記憶。希望大家盡快掌握語法,體驗其中的樂趣。


  1. HTML全稱: HyperText Markup Language ↩︎

  2. HTML全稱: HyperText Markup Language ↩︎

  3. HTML全稱: HyperText Markup Language ↩︎


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM