Markdown常用語法

這是紀念blog架設完成的第一篇文章,對Markdown其實還沒很熟,一邊Google一邊記錄下來,哪天自己不小心忘記還可以回到這邊查詢。

小提醒:網頁版旁邊有導覽目錄可以快速查詢!

Setext(最高階標題)

Setext(第二階標題)

Markdown有兩種標題的語法,Setext和atx形式。
像上面的標題就是Setext形式。
這篇文章主要使用個標題形式

1
2
3
4
第二階標題
===
第二階標題
---

任何數量的_=_和-都可以有效果

atx標題( # atx標題)

1
2
3
4
5
6
# 1號標題
## 2號標題
### 3號標題
#### 4號標題
##### 5號標題
###### 6號標題

簡單來說就像是h1~h6


分隔線

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

以上都是分隔線,由於主題關係這邊分隔線只有一種樣式

引用/謎之音/註解

使用大於符號

我是謎之音

謎之音中的謎之音

1
2
>我是謎之音
>>謎之音中的謎之音

強調

一個星號包起來
一個底線包起來
兩個星號包起來
兩個底線包起來

1
2
3
4
*一個星號包起來*
_一個底線包起來_
**兩個星號包起來**
__兩個底線包起來__

星號等於底線,一個=斜體;兩個=粗體,原理就是加上<em><strong>

超連結

Google

1
[Google](www.google.com)

也可以使用自己部落格內的相對路徑,例如
請到我的 首頁 關於 分類看看吧。

1
請到我的 [首頁](/) [關於](/about) [分類](/categories)看看吧。

大量使用的超連結

如果常常需要使用同一個超連結怎麼辦?我們可以使用超連結標籤
我們可以在任意地方插入 [id]:http://google.com "備註" 這段代碼
你也可以把它放在文件最後面,就像是註解一樣。

不負責任解釋:類似變數的概念,有點像 var id = http://google.com
並且重複使用它。

1
2
[1]: http://google.com  "定義常用超連結的備註,不會顯示"
[a]: http://github.com "定義常用超連結的備註,不會顯示"

我使用了id為1的超連結

我使用了id為a的超連結

程式碼

小段程式碼

使用單個反引號包起來。像是這樣code

1
使用單個反引號包起來。像是這樣`code`

如果要在程式碼區段內插入反引號呢?
像是這樣,程式片段中有單引號
這裡`有`好`多`單`引`號`。
我們可以利用兩個單引號包起來,像是

1
``這裡`有`好`多`單`引`號`。``

謎:什麼時候會用到啊…

程式碼區塊

使用三個單引號,加上javascript(或js),告訴她這是甚麼語法。

''

結果:

1
2
3
function handler(){
console.log('hi')
}

插入圖片

絕對路徑

當Hexo使用到少量圖片時,可以把圖片都放在source/images文件夾中。

1
![圖片不見時的文字說明](/images/image.jpg "圖片說明")

相對路徑

_config.yml文件中找到post_asset_folder把她設為true後,執行$ hexo new post_name,在source/_posts中會生成文章post_name.md和同名文件夾post_name。
把圖片post_name資料夾中,文章就可以使用相對路徑取得圖片了。

1
![](image.jpg)

路徑也可直接放入url拿到網路上的圖片,不用加引號

1
![](https://www.google.com/photos/about/static/images/google.svg)

圖片大小

Markdown 不支持指定圖片大小,但可以直接插入<img />標籤來指定屬性:

GitHub

1
<img src="https://www.google.com/photos/about/static/images/google.svg" alt="GitHub" title="width='200'" width="200" />

列表

一般列表

  • 使用+作為列表,效果一樣。
  • 使用-作為列表,效果一樣。
  • 使用*作為列表,效果一樣。
    1
    2
    3
    + 使用`+`作為列表,效果一樣。
    - 使用`-`作為列表,效果一樣。
    * 使用`*`作為列表,效果一樣。

順序列表

  1. 使用順序列表
  2. 使用順序列表
    1
    2
    1. 使用順序列表
    2. 使用順序列表

符號+1.和文字間要有一個空格

有層級的列表

  1. 1
    1. 1-1
    2. 1-2
  2. 2
    • 項目
    • 項目
1
2
3
4
5
6
1. 1
1. 1-1
2. 1-2
2. 2
+ 項目
+ 項目

待續

2018.08.04 00:35
有用到再補充囉!

0%