---
# System prepended metadata

title: Markdown語法簡介

---

#  Markdown語法簡介


**PHILOSOPHY**

Markdown語法他是一個好寫且好讀為目的，然而可讀性是之中最為重要的!



**INLINE HTML**


> Markdown’s syntax is intended for one purpose: to be used as a format for writing for the web.

Markdown語法也有一個很重要的目的是為了撰寫網頁。

> HTML is a publishing format; Markdown is a writing format. Thus, Markdown’s formatting syntax only addresses issues that can be conveyed in plain text.

HTML是一種為了發表的格式，Marldown 語法則是一種撰寫的格式。

你通常可以直接使用HTML的TAGS在裡面：

```
This is a regular paragraph.

<table>
    <tr>
        <td>Foo</td>
        <td>Foo</td>
        <td>Foo</td>
    </tr>
</table>

This is another regular paragraph.
```


This is a regular paragraph.

<table>
    <tr>
        <td>Foo</td>
        <td>Foo</td>
        <td>Foo</td>
    </tr>
</table>

This is another regular paragraph.




一樣可以在裡面做出表格來~ `<a>`以及`<img>`這些指令也可以直接代替Markdown的語法使用~


然後Markdown的語法部分不能使用在HTML裡面，

E.g., you can’t use Markdown-style ***emphasis*** inside an HTML block.

像這個強調就不能使用。


-----


# 一些基本的使用~


```
斜體：在兩邊加上 *星號* 或是 _底線_
左上角的I

粗體：在兩邊加上 **兩個星號** 或是 __兩個底線__
或是左上角的B也可以做到

刪除線：在兩邊加上 ~~兩個波浪~~
左上角的S

引言(註解)：

> 換行：需在最後面+`兩個空白鍵`··  
> 先以··表示空白

在中間位置的引號也可以做到
```

![](https://i.imgur.com/mvQuJw8.png)


-----

# 大標題



Markdown 提供了六種規格的，分別對應 Html 標籤中的`<h1> ~ <h6>`

# 也可以按左上角H可以達到最大的H1的效果

```
# H1
## H2
### H3
#### H4
##### H5
###### H6
```
顯示結果：
# H1
## H2
### H3
#### H4
##### H5
###### H6


-----

# 有序無序的列表

用點的也很方便喔
![](https://i.imgur.com/faxImUQ.png)



有序列表直接打 `數字`+ `.` + `空白鍵`

1. 有序A 
2. 有序B
	
    
無序列表可以直接使用星號

* 無序列表A
* 無序列表B
	

或是使用HTML語法


```
<ul>
    <li>123
    <li>123

</ul>
```

顯示結果如下

<ul>
    <li>123
    <li>123

</ul>
    
	

-----


# 放入超連結



想把網址PO上去怎麼做:

連結兩邊加上`<` `>`就會產生超連結

	<http://dillinger.io/>  
	
如果只要顯示一串文字來代表超連結:
名稱兩邊加上`[` `]`然後再連結兩邊加上`(` `)`就可以將連結替換成文字連結

	[Dillinger](http://dillinger.io/ "link")
	
產生圖片的方式:
將`[` `]`前+`!`，則可以產生圖片 (把滑鼠指向圖片可以看到註解） png後面那邊的雙引號才會是圖片顯示的文字喔像是我打Logo123，滑鼠只像游標的時候就會顯示出來

	![可以不輸入東西可是一定要有](https://raw.githubusercontent.com/adam-p/markdown-here/master/src/common/images/icon48.png "Logo123")


------


# 程式碼引用以及語法顏色出現

行內的 `程式碼` 用 `反引號` 包起來
區塊的 `程式碼` 用 ```三個反引號```包起來
記得要加上語言名稱 比方 javascript php等等。
當然也可以使用去做選取也很方便
![](https://i.imgur.com/hsqMarf.png)



當你這樣打的時候:
![](https://i.imgur.com/KpgptwG.png)


會顯示成這樣:
```javascript
var s = "JavaScript 語法高亮";
alert(s);
```

```php
$s = "PHP 語法高亮";
echo $s;
```









------





# 表格怎麼做



可以使用跟HTML的語法一樣使用table 跟 tr 以及 td 很方便~
```
<table>
    <tr>
        <td>123</td>
        <td>345</td>
        <td>45o</td>
    </tr>
    <tr>
        <td>456</td>
        <td>Fo456o</td>
        <td>Fo456o</td>
    </tr>
    <tr>
        <td>Fo456o</td>
        <td>Fo345o</td>
        <td>Fo4657o</td>
    </tr>
    
    
</table>
```
顯示如下

<table>
    <tr>
        <td>123</td>
        <td>345</td>
        <td>45o</td>
    </tr>
    <tr>
        <td>456</td>
        <td>Fo456o</td>
        <td>Fo456o</td>
    </tr>
    <tr>
        <td>Fo456o</td>
        <td>Fo345o</td>
        <td>Fo4657o</td>
    </tr>
    
    
</table>




-------



# 參考資料




[Markdown文件](https://markdown.tw/)


[Luka Hackmd教學](https://gist.github.com/codingluka/32fba06ed62821466b726d3c0c9e5fb4)