初識(shí)Markdown

前言:

Markdown所具備的諸多優(yōu)點(diǎn),致使其在程序員、極客圈、自媒體圈和作家圈非常流行。

markdown優(yōu)點(diǎn):

1.極強(qiáng)的兼容性,純文本,很多純文本工具就可以打開。(這就避免了很多尷尬,發(fā)給領(lǐng)導(dǎo)的策劃方案word版本太新,打不開;mac下的.pages格式打不開doc格式;好不容易能打開了,我擦,怎么顯示不一樣呢?)
2.讓你專注于碼字本身而非排版。(markdown本身的輕簡決定了它更能讓你專注于寫作本身,而非排版,word上你能用到的功能可能只有20%,我們大部分的需求markdown就能完美勝任,你說txt純文本不是更能專注么?你用記事本來給我加個(gè)粗看看!專注文字相對(duì)排版來說更加重要,但如果你寫的是詩歌類的,排版也追求極致,行間距也各不一樣,請(qǐng)棄坑。)
3.格式轉(zhuǎn)化非常方便。(本身就屬于標(biāo)記語言,對(duì)于轉(zhuǎn)化為html和各種電子書格式更加輕松,電子書本身就是html轉(zhuǎn)化而來,html也是標(biāo)記語言,這種格式轉(zhuǎn)化就方便很多。)
4.易學(xué)易讀性。markdown語法超級(jí)簡單,如果你之前有過html經(jīng)驗(yàn),那這對(duì)你來說簡直不能太簡單,對(duì)沒接觸過的人只要不是很懶,也是so esay。寫完后易讀性也非常棒。
5.什么?以上理由都不覺得,那么裝逼的理由夠了吧。逼格滿滿,出去一說用markdown寫文檔,一下逼格就起來了,什么當(dāng)?馬克當(dāng)!馬克什么當(dāng)?.......

段落:

非常自然,一行文字就是一個(gè)段落。

比如
這是一個(gè)段落。

會(huì)被解釋成<p>這是一個(gè)段落。</p>

如果你需要另起一段,直接回車換行就行。

這是一個(gè)段落。
這是另一個(gè)段落。

會(huì)解釋成

<p>這是一個(gè)段落<p>
<p>這是另一個(gè)段落</p>

不隔一個(gè)空行的換行行為,在一些編輯器中被解釋為換行,即插入一個(gè)<br />標(biāo)簽。對(duì)與另外一些編輯器,會(huì)被解釋為插入一個(gè)空格。對(duì)于后者,若要插入換行標(biāo)簽,請(qǐng)?jiān)诋?dāng)前一行的結(jié)尾打兩個(gè)空格。

標(biāo)題(Atx方式):

在html里標(biāo)題分為六級(jí),h1、h2、h3、h4、h5、h6,相應(yīng)的,markdown標(biāo)題也是六級(jí)。寫法變?yōu)闃?biāo)題前面加一個(gè)#號(hào),標(biāo)注的寫法是#號(hào)后與標(biāo)題文字間留一個(gè)字符的空格。

# 我是標(biāo)題一
## 我是標(biāo)題二
### 我是標(biāo)題三
#### 我是標(biāo)題四
##### 我是標(biāo)題無
###### 我是標(biāo)題六

測(cè)試后可以看到,標(biāo)題六字體最小,標(biāo)題一字體最大,大代表重要嘛。

我是標(biāo)題一

我是標(biāo)題二

我是標(biāo)題三

我是標(biāo)題四

我是標(biāo)題無
我是標(biāo)題六

標(biāo)題(Setext方式):

有時(shí)候篇幅較短,沒必要分出六級(jí),只需要大小標(biāo)題,這就是和這種方式,寫法是在標(biāo)題文字下用-=符號(hào),但是要-=符號(hào)的數(shù)量大于等于2個(gè)才行。

我是大標(biāo)題
==
我是小標(biāo)題
--

我是大標(biāo)題

我是小標(biāo)題


分割線寫法:

分割線寫法很簡單只需要三個(gè)或更多-_*,但必須是單獨(dú)一行才行,可含空格。

---------------------
***
_____
_ _ _ _




列表:

列表在文章中使用頻率非常高,總結(jié),觀點(diǎn),事項(xiàng)等都需要列表。html里面列表需要ul>li或者ol>li或者dl>dd,但在markdown里面,簡直不要太簡單啊。只需要在列表前加連接符-+*即可,三個(gè)符號(hào)不能混合使用(混合使用就是列表嵌套了),內(nèi)容可以很長。我們來試試:

- 我是列表
- 我也是列表
- 我還是列表長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長
+ 我是列表
+ 我也是列表
+ 我還是列表長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長
* 我是列表
* 我也是列表
* 我還是列表長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長
  • 我是列表
  • 我也是列表
  • 我還是列表長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長
  • 我是列表
  • 我也是列表
  • 我還是列表長長長長長長長長長長長長長長長長長長長長長長長
  • 我是列表
  • 我也是列表
  • 我還是列表長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長長

想要的不是圓點(diǎn)的無序列表,想要數(shù)字的有序列表,只需要在列表前加1. 2. 3.即可,數(shù)字不能省略但可無序,來走起:

1. 我是有序列表1
2. 我是有序列表2
3. 我是有序列表3
3. 我是有序列表1
9. 我是有序列表2
1. 我是有序列表3
  1. 我是有序列表1
  2. 我是有序列表2
  3. 我是有序列表3
  4. 我是有序列表1
  5. 我是有序列表2
  6. 我是有序列表3

很簡單吧,但一定要注意,符號(hào)之后的空格不能少,-1.與文字間一定要留個(gè)字符空格,否則無法正常顯示。

如果需要嵌套列表,則需要-+*幾個(gè)符號(hào)循環(huán)混用,但符號(hào)之前和之后的空格都不能少:

- 嵌套列表1 
  * 嵌套列表2 
  * 嵌套列表3 
    + 嵌套列表4 
- 嵌套列表5
  • 嵌套列表1
    • 嵌套列表2
    • 嵌套列表3
      • 嵌套列表4
  • 嵌套列表5

刪除線:

一部分編輯器支持刪除線,它不是經(jīng)典markdown中的要素。用波浪線~定義刪除線。
如:

~~就像這樣~~

就像這樣
會(huì)被解釋成<strike>就像這樣</strike>

強(qiáng)調(diào):

markdown下想要斜體只需要用*號(hào)或_把你想斜體的文字包裹起來,前面一個(gè)后面一個(gè),單個(gè)就是斜體,雙個(gè)就是粗體。斜體和粗體在文字中都是起強(qiáng)調(diào)作用,粗體要比斜體強(qiáng)調(diào)味道更重寫,所以,粗體寫法就是前后各加兩個(gè)符號(hào)。粗體加斜體就是前后各加三個(gè)符號(hào)。來走一遍:

*我是斜體*
_我是斜體_

我是斜體
我是斜體

**我是粗體**  
__我是粗體__

我是粗體
我是粗體

___我是粗體加斜體___
***我是粗體加斜體***

我是粗體加斜體
我是粗體加斜體

注意了,敲黑板,符號(hào)是可跨行的,符號(hào)也可加空格或者不加。

我在給你**強(qiáng)
調(diào)**一遍:

我才是世界上_最帥_的男人!

我在給你強(qiáng)
調(diào)
一遍:

我才是世界上最帥的男人!

文字鏈接:

插入鏈接不需要其他按鈕,你只需要使用[顯示文本](鏈接地址 "提示文字")這樣的語法即可,提示文字可以用雙引號(hào),單引號(hào)。并且要和鏈接地址有空格。 例如:

[百度](http://www.baidu.com "百度")
[百度](http://www.baidu.com '百度')

百度
百度

注意:括號(hào)是英文狀態(tài)下的,否則顯示有問題。

文字鏈接有兩種,上面的是常見的內(nèi)鏈方式,還有一種叫引用方式。引用方式適合添加多個(gè)網(wǎng)址的文章,可以避免在正文中出現(xiàn)大量網(wǎng)址,保持編輯可讀性;也適合同一網(wǎng)址多處引用,當(dāng)網(wǎng)址有改動(dòng)或修改時(shí),只需修改列表即可,無需逐個(gè)修改,類似宏定義。(注意:[]和網(wǎng)址之間的冒號(hào)是英文字符,網(wǎng)址和后面名稱之間有空格,)例如:

點(diǎn)[簡書][1]寫文章
點(diǎn)[知乎][2]搜知識(shí)
點(diǎn)[谷歌][3]搜圖片
點(diǎn)[百度][4]搜醫(yī)院
點(diǎn)[github][5]搜代碼

[1]:http://jianshu.com "簡書"
[2]:http://zhihu.com "知乎"
[3]:http://google.com "谷歌"
[4]:http://baidu.com "百度"
[5]:http://github.com "github"

點(diǎn)簡書寫文章
點(diǎn)知乎搜知識(shí)
點(diǎn)谷歌搜圖片
點(diǎn)百度搜醫(yī)院
點(diǎn)github搜代碼

markdown 實(shí)現(xiàn)目錄頁內(nèi)跳轉(zhuǎn):

方法一:markdown實(shí)現(xiàn)

* [第一章](#1)
  - [第一節(jié)](#1.1)
  - [第二節(jié)](#1.2)
  - [第三節(jié)](#1.3)
* [第二章](#2)
  - [第一節(jié)](#2.1)
  - [第二節(jié)](#2.2)
  - [第三節(jié)](#2.3)

在正文中,只要將章節(jié)標(biāo)題的id對(duì)應(yīng)上去即可:
<h2 id="1">第一章</h2>
第一章
第一章
第一章
第一章
第一章
<h3 id="1.1">第一節(jié)</h3>
第一章第一節(jié)
第一章第一節(jié)
第一章第一節(jié)
第一章第一節(jié)
第一章第一節(jié)
<h3 id="1.2">第二節(jié)</h3>
第一章第二節(jié)
第一章第二節(jié)
第一章第二節(jié)
第一章第二節(jié)
第一章第二節(jié)
<h3 id="1.3">第三節(jié)</h3>
第一章第三節(jié)
第一章第三節(jié)
第一章第三節(jié)
第一章第三節(jié)
第一章第三節(jié)
<h2 id="2">第二章</h2>
第二章
第二章
第二章
第二章
第二章
<h3 id="2.1">第一節(jié)</h3>
第二章第一節(jié)
第二章第一節(jié)
第二章第一節(jié)
第二章第一節(jié)
第二章第一節(jié)
<h3 id="2.2">第二節(jié)</h3>
第二章第二節(jié)
第二章第二節(jié)
第二章第二節(jié)
第二章第二節(jié)
第二章第二節(jié)
<h3 id="2.3">第三節(jié)</h3>
第二章第三節(jié)
第二章第三節(jié)
第二章第三節(jié)
第二章第三節(jié)
第二章第三節(jié)

在正文中,只要將章節(jié)標(biāo)題的id對(duì)應(yīng)上去即可:
<h2 id="1">第一章</h2>
第一章
第一章
第一章
第一章
第一章
<h3 id="1.1">第一節(jié)</h3>
第一章第一節(jié)
第一章第一節(jié)
第一章第一節(jié)
第一章第一節(jié)
第一章第一節(jié)
<h3 id="1.2">第二節(jié)</h3>
第一章第二節(jié)
第一章第二節(jié)
第一章第二節(jié)
第一章第二節(jié)
第一章第二節(jié)
<h3 id="1.3">第三節(jié)</h3>
第一章第三節(jié)
第一章第三節(jié)
第一章第三節(jié)
第一章第三節(jié)
第一章第三節(jié)
<h2 id="2">第二章</h2>
第二章
第二章
第二章
第二章
第二章
<h3 id="2.1">第一節(jié)</h3>
第二章第一節(jié)
第二章第一節(jié)
第二章第一節(jié)
第二章第一節(jié)
第二章第一節(jié)
<h3 id="2.2">第二節(jié)</h3>
第二章第二節(jié)
第二章第二節(jié)
第二章第二節(jié)
第二章第二節(jié)
第二章第二節(jié)
<h3 id="2.3">第三節(jié)</h3>
第二章第三節(jié)
第二章第三節(jié)
第二章第三節(jié)
第二章第三節(jié)
第二章第三節(jié)

方法二:html 實(shí)現(xiàn)

定義一個(gè)錨鏈接
<span id="jump">要跳轉(zhuǎn)到的地方-文章頂部</span>
使用 markdown語法跳轉(zhuǎn)
[點(diǎn)擊跳轉(zhuǎn)到文章頂部](#jump)

點(diǎn)擊跳轉(zhuǎn)到文章頂部
<span id="jump">要跳轉(zhuǎn)到的地方-文章頂部</span>

簡書上好像不支持這個(gè),會(huì)原樣輸出。博客園的可以。

插入圖片:

插入圖片相比插入鏈接前面只是多個(gè)感嘆號(hào),中括號(hào)里面的文字變?yōu)閳D片描述問題,Tooltips可省略,要設(shè)置大小需要使用<img>標(biāo)簽。

![百度](https://ss0.bdstatic.com/5aV1bjqh_Q23odCf/static/superman/img/logo/bd_logo1_31bdc765.png)
![度娘](https://ss0.bdstatic.com/5aV1bjqh_Q23odCf/static/superman/img/logo/bd_logo1_31bdc765.png "度娘")
百度
百度

度娘
度娘

自動(dòng)鏈接:

用尖括號(hào)括起來就行,要求尖括號(hào)里面必須是鏈接形式,不能是純文本。如:

<百度>
<http://www.baidu.com>
<743043790@qq.com>
<https://ss0.bdstatic.com/5aV1bjqh_Q23odCf/static/superman/img/logo/bd_logo1_31bdc765.png>

http://www.baidu.com
743043790@qq.com
https://ss0.bdstatic.com/5aV1bjqh_Q23odCf/static/superman/img/logo/bd_logo1_31bdc765.png

引用文字

引用文字只需要在要引用的文字前加>符號(hào)并和文本之間保留空格。如:

> 窗前明月光,你光來悲傷

窗前明月光,你光來悲傷

引用代碼

需要引用代碼時(shí),如果引用的語句只有一段,不分行,可以用反引號(hào)`將內(nèi)聯(lián)代碼語句包起來,它們會(huì)解釋成<code>標(biāo)簽(如果代碼的內(nèi)容中有反引號(hào),請(qǐng)用兩個(gè)反引號(hào)包裹,與前后兩個(gè)反引號(hào)之間加空格。代碼中的&、<、>符號(hào)都會(huì)自動(dòng)轉(zhuǎn)義)。如果引用的語句為多行,可以將三個(gè)反引號(hào)```置于這段代碼的首行和末行??床磺暹@個(gè)符號(hào)的,在tab鍵上面那個(gè),反引號(hào)就是。如:

`<strong>我是強(qiáng)調(diào)標(biāo)簽</strong>`

<strong>我是強(qiáng)調(diào)標(biāo)簽</strong>

<html>
  <head>
    <title>我的第一個(gè) HTML 頁面</title>
  </head>
  <body>
    <p>body 元素的內(nèi)容會(huì)顯示在瀏覽器中。</p>
    <p>title 元素的內(nèi)容會(huì)顯示在瀏覽器的標(biāo)題欄中。</p>
  </body>
</html>

另外還有一種原生的風(fēng)格來標(biāo)記代碼區(qū)域,即行首縮進(jìn)四個(gè)空格(這個(gè)支持的并不好,不建議使用)。

引用嵌套:

如:

> This is the first level of quoting.
>
> > This is nested blockquote.
>
> Back to the first level.

This is the first level of quoting.

This is nested blockquote.

Back to the first level.

也可以嵌套其他格式:

> ##### 這是一個(gè)標(biāo)題。
>
> 1.   這是第一行列表項(xiàng)。
> 2.   這是第二行列表項(xiàng)。
>
> 給出一些例子代碼:
>
>     return shell_exec("echo $input | $markdown_script");
這是一個(gè)標(biāo)題。
  1. 這是第一行列表項(xiàng)。
  2. 這是第二行列表項(xiàng)。

給出一些例子代碼:

return shell_exec("echo $input | $markdown_script");

表格

| 列表一 | 列表二 | 列表三 |
| ----- |:-----:| ----:|
| 哈哈  | 哈哈  | 哈哈 |
| 哈哈  | 哈哈  | 哈哈 |
| 哈哈  | 哈哈  | 哈哈 |
列表一 列表二 列表三
哈哈 哈哈 哈哈
哈哈 哈哈 哈哈
哈哈 哈哈 哈哈

或者是

午飯 | 早飯 | 晚飯
------|--------|--------
餃子 | 餃子 | 餃子
餃子 | 餃子 | 餃子
午飯 早飯 晚飯
餃子 餃子 餃子
餃子 餃子 餃子

轉(zhuǎn)義

markdown支持在以下字符前面插入反斜杠 \ 。

\   反斜線
`   反引號(hào)
*   星號(hào)
_   底線
{}  花括號(hào)
[]  方括號(hào)
()  括弧
#   井字號(hào)
+   加號(hào)
-   減號(hào)
.   英文句點(diǎn)
!   驚嘆號(hào)

插入之后,將不再解析這些字符,而是原樣輸出。如:

\ 反斜線
` 反引號(hào)
* 星號(hào)
_ 底線
{} 花括號(hào)
[] 方括號(hào)
() 括弧
# 井字號(hào)
+ 加號(hào)
- 減號(hào)
. 英文句點(diǎn)
! 驚嘆號(hào)

段落縮進(jìn)(空格)

打發(fā)士大夫撒旦法?或?看,飛碟
范德薩發(fā)的?或?看,飛碟
范德薩發(fā)的分 或 到底,飛碟
??段落從此開始。

打發(fā)士大夫撒旦法?或?看,飛碟
范德薩發(fā)的?或?看,飛碟
范德薩發(fā)的分 或 到底,飛碟
??段落從此開始。

內(nèi)聯(lián) HTML

markdown 的語法簡潔,但有其局限性,所以特意保留了內(nèi)聯(lián)html這種方式。任何html標(biāo)簽及其內(nèi)容,都會(huì)原樣輸出到結(jié)果中。也就是說,標(biāo)簽中的星號(hào)等作為markdown結(jié)構(gòu)的符號(hào),以及構(gòu)成html標(biāo)簽和實(shí)體的符號(hào),都不會(huì)做任何轉(zhuǎn)義。

字體、字號(hào)、顏色

<font face="黑體">我是黑體字</font>
<font face="微軟雅黑">我是微軟雅黑</font>
<font face="STCAIYUN">我是華文彩云</font>
<font color=#0099ff size=12 face="黑體">黑體</font>
<font color=#00ffff size=3>null</font>
<font color=gray size=5>gray</font>

具體見html寫法。

剛接觸,算是入門了,驚喜有,失望也有,具體要看使用場(chǎng)景了,這個(gè)排版確實(shí)不行,word還是需要滴。

參考:http://www.kancloud.cn/wizardforcel/markdown-simple-world/97373

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時(shí)請(qǐng)結(jié)合常識(shí)與多方信息審慎甄別。
平臺(tái)聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡書系信息發(fā)布平臺(tái),僅提供信息存儲(chǔ)服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

  • *一、Markdown是什么 * Markdown是一種輕量級(jí)的標(biāo)記語言,使用的標(biāo)記語法非常簡單,它可以使用純文本...
    乘風(fēng)破浪55閱讀 1,076評(píng)論 0 2
  • 開始是使用為知筆記作為平時(shí)的記錄, 發(fā)現(xiàn)為知可以安裝插件 「 Editor.md 」使用 Markdown 寫...
    AlvinMi閱讀 373評(píng)論 0 0
  • 一、概述# Markdown是一種輕量級(jí)的標(biāo)記語言,他的目標(biāo)是實(shí)現(xiàn)易讀易寫,一份使用Markdown格式撰寫的文件...
    sunnyaxin閱讀 1,613評(píng)論 2 3
  • markdown是一種輕量的標(biāo)記語言。剛接觸markdown,熟悉了簡單的命令,記錄下來。 關(guān)于標(biāo)題 如果你編輯:...
    魚f閱讀 389評(píng)論 0 2
  • 灰常感謝Mr_Professor的這篇博文認(rèn)識(shí)Markdown——網(wǎng)絡(luò)寫手的創(chuàng)作神器,讓我有了認(rèn)識(shí)Markdown...
    ask_ME閱讀 416評(píng)論 0 1

友情鏈接更多精彩內(nèi)容