markdown基本語法


一、前言

Markdown是一種可以使用普通文本編輯器編寫的標記語言,通過簡單的標記語法,它可以使普通文本內容具有一定的格式。    --摘自百度百科

沒想到一向不太靠譜的百度百科這次竟有了如此精辟的解釋。之前項目一直使用word撰寫文檔,有比較大的弊病:

  • 只能對純文本文件進行版本控制,而word是二進制格式
  • 格式繁雜,經常需要中斷寫作來控制格式
  • 代碼與文檔分離,給寫文檔造成更大的阻力

而假如單純的使用txt,就沒有一點格式了,用html雖然既有格式又能加入版本控制,但是需要花費較多的時間在標簽上,而且標簽占了文檔的較大百分比,不易閱讀。

所以,最終的解決方案就是 **Markdown** ,作為一種輕量級的標記語言,能在非常短的時間內掌握。而且不僅可以用於寫文檔,還可以寫博客、寫簡書、做一些隨手筆記。Markdown文件以.md結尾,可以導出為html和PDF(需要使用的工具支持)。它是一種語法(個人認為是簡化版的html),但是和html不同的是,各種解析器對其會有不同的表現。比如我的IDEA Markdown插件會把分割線顯示成一條細灰線,Cmd Markdown則是顯示一條虛線。所以建議保持使用一種Markdown工具和盡量使用標准語法。

二、Markdown基本語法

2.1 標題

代碼:

# 一級標題
## 二級標題
### 三級標題
#### 四級標題
##### 五級標題
###### 最小只有六級標題

效果:

過於粗暴,不予以展示,你復制粘貼即知曉!!!

2.2 加粗

代碼:

**我被加粗了**

效果:

我被加粗了

2.3 斜體

代碼:

*我傾斜了了*

效果:

我傾斜了了

2.4 高亮

代碼:

==我高亮了==

效果:

我高亮了

2.5 上標

代碼:

2^2^

效果:

2^2^

2.6 下標

代碼:

H~2~o

效果:

H~2~o

2.7 代碼引用(>式)

代碼:

> hello markdown!

效果:

hello markdown!

代碼:

> hello markdown!
>> hello markdown!

效果:

hello markdown!

hello markdown!

2.8 代碼引用(```式)

代碼:

# 不要復制這一句話,並且去掉下面的反斜杠,謝謝!
\`\`\`python
print('hello nick')
\`\`\`

效果:

print('hello nick')

2.9 代碼引入(`式)

代碼:

# 不要復制這一句話,並且去掉下面的反斜杠,謝謝!
\`print('hello nick')\`

效果:

print('hello nick')

2.10 插入鏈接(鏈接顯示)

代碼:

<https://www.cnblogs.com/nickchen121/p/10718112.html>

效果:

https://www.cnblogs.com/nickchen121/p/10718112.html

2.11 插入鏈接(鏈接描述顯示)

代碼:

[nickchen博客](https://www.cnblogs.com/nickchen121/p/10718112.html "nickchen博客")

效果:

nickchen博客

2.12 插入圖片(鏈接)

代碼:

![數據類型總結-搞笑結束.jpg?x-oss-process=style/watermark](http://www.chenyoude.com/Python從入門到放棄/數據類型總結-搞笑結束.jpg?x-oss-process=style/watermark '描述信息')

效果:

數據類型總結-搞笑結束.jpg?x-oss-process=style/watermark

2.13 插入圖片(圖片路徑)

  • 絕對路徑:.md文本同目錄下圖片的名字,如數據類型總結-搞笑結束.jpg?x-oss-process=style/watermark
  • 相對路徑:圖片在電腦中的路徑地址,如\Users\nick\mac\desktop\數據類型總結-搞笑結束.jpg?x-oss-process=style/watermark

代碼:

![數據類型總結-搞笑結束.jpg?x-oss-process=style/watermark](數據類型總結-搞笑結束.jpg?x-oss-process=style/watermark '描述信息')

![數據類型總結-搞笑結束.jpg?x-oss-process=style/watermark](\Users\nick\mac\desktop\數據類型總結-搞笑結束.jpg?x-oss-process=style/watermark '描述信息')

效果:

數據類型總結-搞笑結束.jpg?x-oss-process=style/watermark

數據類型總結-搞笑結束.jpg?x-oss-process=style/watermark

2.14 有序列表

代碼:

1. one
2. two 
3. three

效果:

  1. one
  2. two
  3. three

2.15 無序列表

代碼:

* one
* two
* three

效果:

  • one
  • two
  • three

2.16 分割線

代碼:

---

效果:


2.17 表格而且第二行必須得有,並且第二行的冒號代表對齊格式,分別為居中;右對齊;左對齊):

name | age | sex 
:-:|:-|-:
tony|20|男
lucy|18|女

效果:

name age sex
nick 19
jason 18

2.18 數學公式(行內嵌)

代碼:

內嵌數學公式$\sum_{i=1}^{10}f(i)\,\,\text{thanks}$

效果:

內嵌數學公式\(\sum_{i=1}^{10}f(i)\,\,\text{thanks}\)

2.19 數學公式(塊狀)

代碼:

$$
\sum_{i=1}^{10}f(i)\,\,\text{thanks}
$$

效果:

\[\sum_{i=1}^{10}f(i)\,\,\text{thanks} \]

三、總結

以上所述就是Markdown的基本標簽,雖然不多,但是可以解決大部分情況。

可以用20%的標簽完成80%的效果

基礎markdown語法參考:https://www.appinn.com/markdown/

插入數學公式markdown語法參考:https://www.zybuluo.com/codeep/note/163962


免責聲明!

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



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