Firefly开源社区

MarkDown常用语法汇总

105

积分

0

威望

0

贡献

技术小白

积分
105
发表于 2017-3-14 11:45:42     
Markdown是一种轻量级的标记语言,语法十分简单,目前也被越来越多的写作爱好者,撰稿者广泛使用。我们日常写文档过程中,最麻烦的莫过于排版了,比起使用word文档,我认为Markdown写文档更加方便、排版也十分好看。下面就介绍以下markdown的一些常用语法。
(由于下面文字是Markdown编写的,而帖子不支持markdown,所以想看效果请看这里http://168.168.0.253:9000/blog/post/lxp@t-chip.com.cn/8bf444b68c0c或者复制下面文字到支持markdown的编辑器)
##标题
在Markdown中,一段文字被定义为标题,在文字前面添加`#`号就可以了:
#一级标题
##二级标题
###三级标题
`#一级标题`、`##二级标题`、`###三级标题`

##引用
当我们需要引用一段文字的时候,例如
>这是一段引用的文字

在句子开头添加一个`>`:
`>这是一段引用的文字`

##代码区块
代码区块是我们最常用的功能了。在HTML中,我们一般是使用`<pre></pre>`包裹代码块。MarkDown语法中我们当然可以使用`<pre></pre>`,另外,我们也能通过输入4个空格或者1个制表符实现。

    function HelloWorld(){
    //代码
    }
##代码关键字
有时候我们需要在文档里引用一小段代码,这时候我们可以通过<code>``</code>包裹关键字,与<code>&lt;code>&lt;/code></code>有一样的效果:

`helloWorld()`

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

###无序列表
无序列表使用星号、加号或是减号作为列表标记,符号前后要有空格,而在符号前面添加一个空格,可变为下一级子项。

> * 这里使用星号
> + 这里使用加号
> - 这里使用减号
> * 一级目录
>  * 一级目录子项
>  * 一级目录子项
>       * 二级目录子项

###有序列表
有序列表有数字与`.`组成,`.`后需要有空格。
>1. 测试1
>2. 测试2
>3. 测试3

#表格

表格在 Markdown中使用比较麻烦

    | Tables        | Are           | Cool  |
    | ------------- |:-------------:| -----:|
    | col 3 is      | right-aligned | \$1600 |
    | col 2 is      | centered      |   \$12 |
    | zebra stripes | are neat      |    \$1 |

这种语法生成的表格如下:
| Tables        | Are           | Cool  |
| ------------- |:-------------:| -----:|
| col 3 is      | right-aligned | \$1600 |
| col 2 is      | centered      |   \$12 |
| zebra stripes | are neat      |    \$1 |
#斜体 粗体
在MarkDown中,只要在文字前后添加`*`就能显示斜体(一般用于强调);添加`**`则显示粗体
*斜体*
**粗体**
#图片

要在纯文字应用中设计一个「自然」的语法来插入图片是有一定难度的。

Markdown 使用一种和链接很相似的语法来标记图片,同样也允许两种样式: 行内式和参考式。

行内式的图片语法看起来像是:

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

    ![Alt text](/path/to/img.jpg "Optional title")
详细叙述如下:

一个感叹号 !
接着一个方括号,里面放上图片的替代文字
接着一个普通括号,里面放上图片的网址,最后还可以用引号包住并加上 选择性的 'title' 文字。
参考式的图片语法则长得像这样:

    ![Alt text][id]
「id」是图片参考的名称,图片参考的定义方式则和连结参考一样:

[id]: url/to/image  "Optional title attribute"
到目前为止, Markdown 还没有办法指定图片的宽高,如果你需要的话,你可以使用普通的 <img> 标签。
#链接
用`<>`包裹起来的文字,MarkDown会把他转为链接

    <http:\\www.baidu.com>

<http:\\www.baidu.com>
#反斜杠
`\`可以将一些含有特殊意义的字符转为普通字符,例如

    *test*

我不希望显示斜体,而是显示\*test\*的时候,我可以使用`\`,将`*`转为普通字符

    \*test\*
#分割线
连续4个减号、星号,MarkDown会把他识别为一条分割线,如下:

----

****

    ----

    ****
#其他
MarkDown同时**兼容HTML**,你可以在MarkDown使用大部分html的标签例如`<img>`



回复

使用道具 举报

3746

积分

17

威望

18

贡献

官方团队

Rank: 9Rank: 9Rank: 9

积分
3746
发表于 2017-3-16 09:00:01     
回复

使用道具 举报

您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

友情链接 : 爱板网 电子发烧友论坛 云汉电子社区 粤ICP备14022046号-2
快速回复 返回顶部 返回列表