Markdown 入门指南

2016-04-29  本文已影响0人  云沙前端

Markdown基本语法入门指南

Markdown的目标是实现【易读易写】。它兼容HTML ,它的语法目标是:成为一种适用于网络的书写语言。

特殊字符自动转换

在HTML文件中,有两个字符需要特殊处理:< 和 &。<符号用于起始标签,&符号则用于标记HTML实体,如果你只是想要显示这些字符的原型,你必须要使用实体的形式,像是&lt+;和&amp+;。


标题

Markdown支持两种标题的语法,类 Setext 和 atx形式。

其中Setext是用 底线来做标记的 利用=(最高阶标题)和-(第二阶标题),

例如

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

This is an H1

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

This is an H2

Ps:任何数量的= 和-都可以有效果

类Atx 是在行首插入 1 到 6 个#,对应到标题1 到 6阶,

例如

# 这是 H1

## 这是 H2

###### 这是H6

这是 H1

这是 H2

这是H6

区块引用Blockquotes :

引用的区块内也可以使用其他的Markdown语法,包括标题、列表、代码区块等:
>##这是一个标题
>
>1.  这是第一行列表项。
>2. 这是第二行列表项。
>
>给出一些例子代码:
>
>  return shell_exec("echo $input | $markdown_script");

这是一个标题

  1. 这是第一行列表项。
  2. 这是第二行列表项。

给出一些例子代码:

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


列表

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

无序列表使用星号、加号或是减号作为列表标记:

*  Red
*  Green
*  Blue

+  Red
+  Green
+  Blue

-  Red
-  Green
-  Blue
有序列表 使用数字接着一个英文句点:
1. Bird
2. Math
3. Yellow
很重要的一点是,你在列表标记上使用的数字并不会影响输出的HTML结果,上面的列表所产生的HTML 标记为:
<ol>
<li>Bird</li>
<li>Math</li>
<li>Yellow</li>
</ol>
即使你写成
1. Bird
1. Math
1.Yellow
也不影响HTML的输出
  1. Bird
  2. Math
  3. Yellow
上一篇下一篇

猜你喜欢

热点阅读