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)

百度头条
百度头条

转义字符

用\将特殊字符如*, [, > 变成普通字符

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容