上面使用 [toc]
目錄
哲學
Markdown的目標是實現「易讀易寫」。
不過最需要強調的便是它的可讀性。一份使用Markdown格式撰寫的文件應該可以直接以純文字發佈,並且看起來不會像是由許多標籤或是格式指令所構成。
本篇網頁使用 Markdown 編寫
標題
可以用 ‘========’ or ‘——–’
也可用 ######
原始內文 | 顯現方式 html |
---|---|
我是標題 ———– |
<h2>我是標題</h2> |
原始內文 | 顯現方式 html |
---|---|
#我是h1 |
<h1>我是h1</h1> |
##我是 h2 |
<h2>我是 h2</h2> |
###我是 h3 |
<h3>我是 h3</h3> |
####我是 h4 |
<h4>我是 h4</h4> |
#####我是 h5 |
<h5>我是 h5</h5> |
######我是 h6 |
<h6>我是 h6</h6> |
Note:
- 用’=====’ 等同於 h1
- 用’——–’ 等同於 h2
- h4 是最接近內文字體大小
- 沒有 h7 啦 !!
內文
原始內文 | 顯現方式 (html) |
---|---|
**我是粗體字** |
我是粗體字 |
*我是斜體字* |
我是斜體字 |
`一行程式碼` | <code>一行程式碼</code> |
<kbd>我是鍵盤符號</kbd> |
我是鍵盤符號 |
<mark>Marked</mark> |
Marked |
使用註腳( 很少用)
You can create footnotes like this.1
You can create footnotes like this .<sup>[^footnote]<sup>
[^footnote]: Here is the *text* of the **footnote**.
連結
This is [an example](http://example.com/ "Title") inline link.
產生
This is an example inline link.
產生原始碼:
<p>This is <a href="http://example.com/" title="Title">
an example</a> inline link.</p>
<p><a href="http://example.net/">This link</a> has no
title attribute.</p>
增加可讀性,可用:
This is [an example] [id] reference-style link.
[id]: http://example.com/ "Optional Title Here"
This is an example reference-style link.
簡化:
[Google][]
[Google]: http://google.com/
若在文章中想要跳到某一標題可用 (#標題)
跳到[分隔線](#分隔線)
跳到[某網頁標題](http://jimmyhuang19.blogspot.tw/2016/11/markdown.html#連結)
清單
* Red
* Green
* Blue
- Red
- Green
- Blue
想要有數字的清單
1. Bird
2. McHale
3. Parish
- Bird
- McHale
- Parish
不想有前面的符號可用 :
Term 1
Term 2
: Definition A
: Definition B
- Term 1
- Term 2
- Definition A
- Definition B
分隔線
你可以在一行中用三個或以上的星號、減號、底線來建立一個分隔線,行內不能有其他東西。
例如:
*** ,--- ,___ ,* * *
要用減號 —,須注意前行是否有文字,要不然 Markdown 會誤認是標題,最好用就是***
程式碼
小段程式碼可用 ` 轉換成<code>
Use the `printf()` function.
會產生:
<p>Use the <code>printf()</code> function.</p>
有需要分行:只要簡單地縮排4個空白或是1個tab就可以
輸出會是<pre><code>
有亮點和分段的程式碼 使用 ` ` ` 我是程式碼 ` ` `
圖片
![Alt text](/path/to/img.jpg)
![Alt text](/path/to/img.jpg "Optional title")
簡化
![Alt tefxt][a1]
[a1]: /path/to/img.jpg "Optional title"
表格
Item | Value
-------- | ---
Computer | $1600
Phone | $12
Pipe | $1
Item | Value |
---|---|
Computer | $1600 |
Phone | $12 |
Pipe | $1 |
| Item | Value | Qty |
| :------- | ----: | :---: |
| Computer | $1600 | 5 |
| Phone | $12 | 12 |
| Pipe | $1 | 234 |
其中|:—–| 是指對齊方式
Item | Value | Qty |
---|---|---|
Computer | $1600 | 5 |
Phone | $12 | 12 |
Pipe | $1 | 234 |
<table>
<tr>
<td> 1 </td><td>2</td>
</tr>
<tr>
<td>3</td><td>4</td>
</tr>
</table>
1 | 2 |
3 | 4 |
3 | 4 |
3 | 4 |
使用純 html 語法時,例如用
<table>
,裡面不能使用 Markdown 的語法,就是不能用**粗體字**
一定要用<strong>
提示引言
區塊引言可以加上 >
> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
> consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
> Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
>
> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
> id sem consectetuer libero luctus adipiscing.
可產生出 <blockquote >
程式碼
顯示特殊字元
這些是Markdown的關鍵字
\ 反斜線
` 反引號
* 星號
_ 底線
{} 大括號
[] 方括號
() 括號
# 井字號
+ 加號
- 減號
如果你要使用,Markdown會認為是特殊用途。
若要顯示出關鍵字可在前面加 \
其他一些特殊符號,如空格,可使用實體符號 Entity Name
空格 :
或用 ` 用顯示程式碼替代
空格應該少用,不但不好看,也會減少可讀性,可用程式相關語法來代替。
參考資料
- Here is the text of the footnote. ↩
沒有留言:
張貼留言