Markdown 編輯器語法 專題

基本技巧

代碼

若是你只想高亮語句中的某個函數名或關鍵字，可使用 `function_name()` 實現

一般編輯器根據代碼片斷適配合適的高亮方法，但你也能夠用 ```(tab鍵上的符號，要從每行第一個列開始，```後要緊跟着語言) 包裹一段代碼，並指定一種語言

```javascript
$(document).ready(function () {
    alert('hello world');
});
```

支持的語言：actionscript, apache, bash, clojure, cmake, coffeescript, cpp, cs, css, d, delphi, django, erlang, go, haskell, html, http, ini, java, javascript, json, lisp, lua, markdown, matlab, nginx, objectivec, perl, php, python, r, ruby, scala, smalltalk, sql, tex, vbscript, xml

也可使用 4 空格縮進，再貼上代碼，實現相同的的效果

def g(x):
    yield from range(x, 0, -1)
yield from range(x)

```properties
org.springframework.boot.test.autoconfigure.web.servlet.AutoConfigureMockMvc=\
org.s.boot.test.autoconfigure.web.servlet.MockMvcAutoConfiguration,\
org.s.boot.test.autoconfigure.web.servlet.MockMvcSecurityAutoConfiguration,\
org.s.boot.test.autoconfigure.web.servlet.MockMvcWebClientAutoConfiguration,\
org.s.boot.test.autoconfigure.web.servlet.MockMvcWebDriverAutoConfiguration
```

 

 

標題

Markdown中標題若是想定義一個標題，能夠在前面加上#(或者用#將標題括起來)。1-6個#分別表示1-6級標題。有的編輯器須要在#和正文之間加一個空格(Atom)，有的編譯器不用(MarkdownPad)，爲了保持同一建議都加上空格。

# 標題一 #標題一# ## 標題二

顯示結果：

標題一

標題一

標題二

文本樣式

Markdown支持4中文本樣式，分別是：加粗、斜體、刪除線和加粗且斜體。

樣式	關鍵字	快捷鍵	樣例	輸出
加粗	** **或者__ __	command/control+b	**加粗文本**	加粗文本
斜體	* *或者_ _	command/control+i	_斜體文本_	斜體文本
刪除線	~~ ~~	無	~~刪除線~~	刪除線
加粗且斜體	** **和_ _	無	**這個是：_加粗且斜體_**	**_這個是_加粗且斜體**

這篇隨筆也是用Markdown寫的，預覽了一下發現博客園不支持加粗且斜體渲染。因而乎我截了一張我用Atom渲染後的結果

表中的快捷鍵是幾乎全部編輯器都支持的，「無」是沒有統一支持的要求，也許有的編輯器支持。command是mac上的鍵。

引用文本

引用文本的關鍵字是>。

下面是一個引用：
>你們好！我是一個引用。

輸出結果：

下面是一個引用：

你們好！我是一個引用

引用代碼

引用代碼有兩種形式，一種是在文本中引入一個代碼：使用一個倒引號`括起來；另外一種是插入一段代碼：使用三個倒引號```括起來(非標準Markdown語法,Atom中支持MarkdownPad中不支持)。

我須要在文中插入快捷鍵`ctrl+v`.

結果：

我須要在文中插入快捷鍵ctrl+v.

我須要引用一段代碼：  
``` c++
int a = 1; int b = 2; int c = a+b; ```

結果：

我須要引用一段代碼：

int a = 1; int b = 2; int c = a+b;

上面能夠直接在三個倒引號後面加入引用代碼的語言類型。編輯器會對應的進行渲染。固然咱們也能夠直接使用一個tab或四個空格來表示我要插入一段代碼（Atom中是2個tab）。

int a = 1; int b = 2; int c = a+b;

結果：

int a = 1; int b = 2; int c = a+b;

連接

Git編譯器關於連接的使用加入了較多的擴展。這裏僅介紹標準Markdown語法中的行內連接和參考連接。
下面是行內連接示例：

[連接到百度](https://www.baidu.com "百度") 

結果：

連接到百度

下面是一個參考連接的示例：

[連接到百度][1] [連接到Google][2] [仍是連接到百度][1] [1]:https://www.baidu.com [2]:https://www.google.com 

結果：

連接到百度
連接到Google
仍是連接到百度

參考連接中的標號1,2不單單能夠是數字，也能夠是字母或它們的組合。
同時連接也支持相對路徑，./表示當前目錄，../表示前一級目錄。這裏也建議在編寫文檔時，不一樣文檔之間的關聯採用相對路徑的形式。

列表

咱們可使用*,+,-或者數字做爲列表的關鍵字。同時列表也支持嵌套的形式。

- 主列表1 - 主列表2 1. 次列表1 2. 次列表2 + 主列表3

結果：

• 主列表1
• 主列表2

1. 次列表1
2. 次列表2

• 主列表3

任務列表

任務列表是Git對標準Markdown語法的擴展，並非標準Markdown語法。所以MarkdownPad不會對該語法進行渲染。可是使用Atom就會對該語法進行渲染。

- [x] 任務列表1 - [ ] 任務列表2 - [ ] 任務列表3

結果：

• [x] 任務列表1
• [ ] 任務列表2
• [ ] 任務列表3

使用表情

Git中的Markdown語法擴展中包括了一些表情包。這個表情包語法依然能夠經過Atom進行渲染。因爲不是標準的Markdown語法不能經過MarkdownPad渲染。

表情一：:+1:,表情二：:o:

表情一：👍,表情二：⭕

一樣博客園對錶情包的渲染也支持的不太好，有的不支持，上面的兩個表情支持但效果也不太好。我這裏截取了Atom中渲染後的結果。Atom雖然有一些bug，可是功能仍是比較強大的，添加合適的插件公式都能渲染。可是在輕量級標記語言中加入太複雜的元素，又違背了其設計的初衷。並非擴展的功能越多越好。輕量級標記語言的定位就是快速，其次纔是功能多，否則用HTML得了。這個話題扯得有點遠了~~。

更多表情能夠查看表情大全。

忽略Markdown關鍵字

和C語言printf函數同樣，若是咱們不想讓某個字符轉換成Markdown關鍵字，能夠在前面加上轉義符"\" .好比咱們想輸入兩個*,就能夠用：

\*\*取消Markdown關鍵字

 

輸出結果:

**取消Markdown關鍵字

採用表格形式組織信息

表格一樣不是標準的Markdown語法，使用MarkdownPad不會對該格式進行渲染。
形式一：

|表頭一|表頭二|  
|------|---| |內容一|內容二| |內容三|內容四|

顯示結果：

表頭一	表頭二
內容一	內容二
內容三	內容四

須要注意的是，第二行中的-只要有三個或三個以上便可。沒有具體的個數要求。

形式二：
帶左中右對其的表格。

|左對齊|居中對齊|右對齊|
|:- |:------:|-:| |左對齊列|居中對齊列|右對齊列| |1|2|3|

左對齊	居中對齊	右對齊
左對齊列	居中對齊列	右對齊列
1	2	3

一樣對於第二列中的空格數沒有要求，但至少要有一個-。

 

https://www.cnblogs.com/yabin/p/6366151.html

 

 

 

圖片

跟連接的方法區別在於前面加了個感嘆號 !，這樣是否是以爲好記多了呢？

![圖片名稱](http://圖片網址)

固然，你也能夠像網址那樣對圖片網址使用變量

這個連接用 1 做爲網址變量 [Google][1].
而後在文檔的結尾位變量賦值（網址）

[1]:http://www.google.com/logo.png

也可使用 HTML 的圖片語法來自定義圖片的寬高大小

<img src="htt://example.com/sample.png" width="400" height="100">

換行

若是另起一行，只需在當前行結尾加 2 個空格

在當前行的結尾加 2 個空格
這行就會新起一行

若是是要起一個新段落，只須要空出一行便可。

分隔符

若是你有寫分割線的習慣，能夠新起一行輸入三個減號-。當先後都有段落時，請空出一行：

前面的段落

---

後面的段落

 

高級技巧

行內 HTML 元素

目前只支持部分段內 HTML 元素效果，包括 <kdb> <b> <i> <em> <sup> <sub> <br> ，如

鍵位顯示

使用 <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd> 重啓電腦 

代碼塊

使用 <pre></pre> 元素一樣能夠造成代碼塊

粗斜體

<b> Markdown 在此處一樣適用，如 *加粗* </b>

符號轉義

若是你的描述中須要用到 markdown 的符號，好比 _ # * 等，但又不想它被轉義，這時候能夠在這些符號前加反斜槓，如 \_ \#\* 進行避免。

\_不想這裏的文本變斜體\_ \*\*不想這裏的文本被加粗\*\* 

擴展

支持 jsfiddle、gist、runjs、優酷視頻，直接填寫 url，在其以後會自動添加預覽點擊會展開相關內容。

http://{url_of_the_fiddle}/embedded/[{tabs}/[{style}]]/
https://gist.github.com/{gist_id}
http://runjs.cn/detail/{id}
http://v.youku.com/v_show/id_{video_id}.html

公式

當你須要在編輯器中插入數學公式時，可使用兩個美圓符 $$ 包裹 TeX 或 LaTeX 格式的數學公式來實現。提交後，問答和文章頁會根據須要加載 Mathjax 對數學公式進行渲染。如：

$$x = {-b \pm \sqrt{b^2-4ac} \over 2a}.$$ $$ x \href{why-equal.html}{=} y^2 + 1 $$ 

同時也支持 HTML 屬性，如：

$$(x+1)^2 = \class{hidden}{(x+1)(x+1)}$$ $$ (x+1)^2 = \cssId{step1}{\style{visibility:hidden}{(x+1)(x+1)}} $$

https://segmentfault.com/markdown#articleHeader2