Markdown學習筆記

原文地址:LoveDev

Markdown:一種簡單易學功能強大、任何文本編輯器都可以編寫的標記語言。目前 github、Stackoverflow 等網站都支持這種格式。

標題

Markdown 支持兩種標題的語法,類 Setext 和類 atx 形式。

類 Setext 形式是用底線的形式,利用 = (最高階標題)和 - (第二階標題),例如:

This is an H1
=============

This is an H2
-------------

任何數(shù)量的 = 和 - 都可以有效果,要寫在文章的最開頭才會有效果。

類 Atx 形式則是在行首插入 1 到 6 個 # ,對應到標題 1 到 6 階,例如:

# 這是 H1

## 這是 H2

###### 這是 H6

區(qū)塊引用

引用別人文字的時候,這個格式就顯得非常必要。Markdown 標記區(qū)塊引用是使用類似 email 中用 > 的引用方式。

> 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.

Markdown 也允許你偷懶只在整個段落的第一行最前面加上 > :

> 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.

區(qū)塊引用可以嵌套(例如:引用內的引用),只要根據層次加上不同數(shù)量的 > :

 This is the first level of quoting.
>
> > This is nested blockquote.
>
> Back to the first level.

引用的區(qū)塊內也可以使用其他的 Markdown 語法,包括標題、列表、代碼區(qū)塊等:

> ## 這是一個標題。
> 
> 1.   這是第一行列表項。
> 2.   這是第二行列表項。
> 
> 給出一些例子代碼:
> 
>     return shell_exec("echo $input | $markdown_script");

注:>和文本之間要保留一個字符的空格。

列表

Markdown 支持有序列表和無序列表。

無序列表可以使用星號、加號或是減號作為列表標記:

*   Red
*   Green
*   Blue

+   Red
+   Green
+   Blue

-   Red
-   Green
-   Blue

注:上面的三種格式效果都相同,符號后面保留一個字符的空格。

有序列表則使用數(shù)字接著一個英文句點:

1.  Bird
2.  McHale
3.  Parish

分割線

可以在一行中用三個以上的星號、減號、底線來建立一個分隔線,行內不能有其他東西。

***
************
---
------------

鏈接

Markdown 支持兩種形式的鏈接語法: 行內式和參考式兩種形式,不管是哪一種,鏈接文字都是用 [方括號] 來標記。

This is [an example](http://example.com/ "Title") inline link.
[This link](http://example.net/) has no title attribute.

隱式鏈接標記功能讓你可以省略指定鏈接標記,這種情形下,鏈接標記會視為等同于鏈接文字,要用隱式鏈接標記,只需要在鏈接文字后面加上一個空的方括號:

[Google][]

定義鏈接內容:

[Google]: http://google.com/

注:鏈接的定義可以放在文件中的任何一個地方,最好放到文件最后集中管理。

參考式鏈接的范例:

[Google] [1]
[Baidu] [2] 
[LoveDev] [3]

  [1]: http://google.com/       "Google Search"
  [2]: http://baidu.com/        "Baidu Search"
  [3]: http://lovedev.org/      "My Blog "

參考式的鏈接其實重點不在于它比較好寫,而是它比較好讀以及易于維護,文章內容不需要改變,只用改變標示對應的鏈接就可以了。

強調

Markdown 使用星號(*)和底線(_)作為標記強調字詞的符號,被 * 或 _ 包圍的字詞會被轉成用 <em> 標簽包圍,用兩個 * 或 _ 包起來的話,則會被轉成 <strong>。

*single asterisks*

_single underscores_

**double asterisks**

__double underscores__

會轉成:

<em>single asterisks</em>

<em>single underscores</em>

<strong>double asterisks</strong>

<strong>double underscores</strong>

注:唯一的限制是,用什么符號開啟標簽,就要用什么符號結束。

代碼

如果要標記一小段行內代碼,你可以用反引號把它包起來(`)。

Use the `printf()` function.

如果要在代碼區(qū)段內插入反引號,你可以用多個反引號來開啟和結束代碼區(qū)段:

``There is a literal backtick (`) here.``

圖片

Markdown 使用一種和鏈接很相似的語法來標記圖片,同樣也允許兩種樣式: 行內式和參考式。

行內式的圖片語法:

![](/path/to/img.jpg)

![](/path/to/img.jpg "Optional title")

詳細敘述如下:

  • 一個驚嘆號 !
  • 接著一個方括號,里面放上圖片的替代文字
  • 接著一個普通括號,里面放上圖片的網址,最后還可以用引號包住并加上 選擇性的 'title' 文字。

參考式的圖片語法:

![Alt text][id]

「id」是圖片參考的名稱,圖片參考的定義方式和參考式鏈接一樣:

[id]: url/to/image  "Optional title attribute"

反斜杠

Markdown 可以利用反斜杠來插入一些在語法中有其它意義的符號。

\*literal asterisks\*

Markdown 支持以下符號前面加上反斜杠來幫助插入普通的符號:

\   反斜線
`   反引號
*   星號
_   底線
{}  花括號
[]  方括號
()  括弧
#   井字號
+   加號
-   減號
.   英文句點
!   驚嘆號

自動鏈接

Markdown 支持以比較簡短的自動鏈接形式來處理網址和電子郵件信箱,只要是用方括號包起來, Markdown 就會自動把它轉成鏈接。例如:

<http://example.com/>

Markdown 會轉為:

<a >http://example.com/</a>

郵址的自動鏈接也很類似,只是 Markdown 會先做一個編碼轉換的過程,把文字字符轉成 16 進位碼的 HTML 實體,這樣的格式可以糊弄一些不好的郵址收集機器人,例如:

<616651408@qq.com>

Markdown 會轉成:

<a href="mailto:addre
ss@example.co
m">address@exa
mple.com</a>
最后編輯于
?著作權歸作者所有,轉載或內容合作請聯(lián)系作者
【社區(qū)內容提示】社區(qū)部分內容疑似由AI輔助生成,瀏覽時請結合常識與多方信息審慎甄別。
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發(fā)布,文章內容僅代表作者本人觀點,簡書系信息發(fā)布平臺,僅提供信息存儲服務。

相關閱讀更多精彩內容

  • 為什么學習Markdown 自從搭建了 Hexo 博客之后,發(fā)現(xiàn)還有 Markdown 這種寫文章的方法,想到以后...
    lifeColder閱讀 20,481評論 10 216
  • Markdown語法 段落和換行 一個段落的結束是它的后面有一行空白,例如: 如果要換行的話,就需要在后面加兩個以...
    大道至簡峰閱讀 566評論 0 4
  • 前言 一直很想好好打理自己的博客,可是每次寫學習筆記之類的東東的時候都備受折磨。終于,在昨天,我遇見了Markdo...
    零小白閱讀 1,289評論 0 4
  • 1 區(qū)塊元素 1.1 段落 一個 Markdown 段落是由一個或多個連續(xù)的文本行組成,它的前后要有一個以上的空行...
    markouy閱讀 1,030評論 0 0
  • 標題 實現(xiàn)方法一: This is an H1 This is an H2 實現(xiàn)方法二: 這是 H1 這是 H2 ...
    陳小陌丿閱讀 365評論 0 0

友情鏈接更多精彩內容