-->

2016-11-25

Markdown 整理

上面使用 [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/

Google

若在文章中想要跳到某一標題可用 (#標題)

跳到[分隔線](#分隔線)
跳到[某網頁標題](http://jimmyhuang19.blogspot.tw/2016/11/markdown.html#連結)

跳到分隔線
跳到某網頁標題


清單

    *   Red
    *   Green
    *   Blue
  • Red
  • Green
  • Blue

想要有數字的清單

    1.  Bird
    2.  McHale
    3.  Parish
  1. Bird
  2. McHale
  3. 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 tefxt

![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
34
34
34

使用純 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
空格 : &nbsp; 或用 ` 用顯示程式碼替代

空格應該少用,不但不好看,也會減少可讀性,可用程式相關語法來代替。


參考資料

markdown.tw
StackEdit


  1. Here is the text of the footnote.

沒有留言: