Markdown語法紀要

(I) 區塊內容 Block

段落和換行

LATEX一樣,用一個以上的空行代表分段,而沒有空行的換行被忽略,所以允許段內強制 換行

標題

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

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

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

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

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

# This is an H1

## This is an H2

###### This is an H6

引言

Markdown使用email形式的區塊引言,如果你很熟悉如何在email信件中引言,你就知道怎麼在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.

或者只在段落第一行加上>:

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

看起來效果像這樣:

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.

區塊引言可以有階層(例如:引言內的引言),只要根據層數加上不同數量的>:

This is the first level of quoting.

This is nested blockquote.

Back to the first level.

引言的區塊內也可以使用其他的Markdown語法,包括標題、清單、程式碼區塊等:

This is a header.

  • This is the first list item.
  • This is the second list item.

Here's some example code:

  return shell_exec("echo $input | $markdown_script");

清單

無序清單

使用星號、加號或是減號作為清單標記:

* Red
* Green
* Blue

等同於:

+ Red
+ Green
+ Blue

也等同於:

- Red
- Green
- Blue

有序清單

有序清單則使用數字接著一個英文句點,但是序號數字可以隨意,只要是數字即可,例如:

1.  Bird
2.  McHale
3.  Parish

效果等同于:

3. Bird
1. McHale
8. Parish

看起來都是:

  1. Bird
  2. McHale
  3. Parish

源代碼

縮排4個空白或是1個tab就可以

分割線

在一行中用三個或以上的星號、減號、下劃線來建立一個分隔線,行內不能有其他東西。你也可以在星號中間插入空白。下面每種寫法都可以建立分隔線:

*********
__________

(II) 段內元素

強調

Markdown使用星號*和底線_作為標記強調字詞的符號,被*_包圍的字詞會被轉成斜體,用兩個*_包起來的話,則會被轉成黑體,例如:
single asterisks

_single underscores_

**double asterisks**

__double underscores__

看起來是這樣:

single asterisks

single underscores

double asterisks

double underscores

段內源代碼

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

Use the `printf()` function.

看起來就是: Use the printf() function.

超鏈接

被鏈接的文字用[]包起來,在方塊括號后面馬上接著括號并插入網址連結即可,比如:

This is [an example](http://example.com/ "Title") inline link.

[This link](http://example.net/) has no title attribute.

看起來像:

This is an example inline link.

This link has no title attribute.

圖片

與超鏈接類似,不過在前面多加一個感嘆號:
![百度頭條](http://tieba.baidu.com/p/3137905063)

百度頭條
百度頭條

轉義字符

用\將特殊字符如*, [, > 變成普通字符

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。

推薦閱讀更多精彩內容