前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >Markdown语法简介

Markdown语法简介

作者头像
黄Java
发布2018-09-18 17:10:50
5030
发布2018-09-18 17:10:50
举报

目的

对Markdown的语法进行最基础简单的介绍,能够满足在各个方面的基本使用。

说明

markdown语法目前有两种,我会选择一种我在实践过程中认为比较简单的标记来进行简单介绍。如果需要进行查阅,可以直接阅读末尾总结部分。

markdown也支持部分HTML,如果需要实现换行等需求也可以使用<br/>等来完成。

不同的markdown语法识别器可能会对统一份markdown语法产生不同的解释,属于正常现象。

segmentfault的markdown解释器就和我使用的MacDown产生了不同的结果,害得我调调整了好久囧~~

工具

本人是在Mac上进行工作与开发,因此推荐Mac上的软件——MacDown进行开发,windows上的用户可以自行挑选较为合适的客户端或者选择跨平台的线上编辑器。

语法简介

段落

段落以#号开头,1个#代表为一级标题,以此类推,2~6个#分别为2~6级标题。其中#后建议添加一个空格

列表

列表分为有序列表和无序列表两种。

有序列表

数字+.+空格为开头的语句,会被识别成为一个有序列表。例如:

1.(空格)a
2.(空格)b
3.(空格)c

会被识别为:

  1. a
  2. b
  3. c

无序列表

-+空格为开头的语句,会被识别为一个无序列表。例如:

-(空格)a
-(空格)b
-(空格)c

会被识别为:

  • a
  • b
  • c

链接

符合[名字]+(网址)格式的语句会被识别为一个超链接,其中小括号中为超链接显示的名字,而中括号为链接的网址。例如:

[百度](www.baidu.com)

会被识别为:

百度

图片

符合!+[]+(图片网址)格式的语句会被识别为一个图片,其中小括号为图片的网址。例如:

![](http://www.taopic.com/uploads/allimg/120628/201776-12062Q4295216.jpg)

会被识别为:

引用

符合>+空格格式的语句会被识别为一个图片,其中后面紧接的文字为引用文字。例如:

(>)(空格)引用——去掉大于号左右的括号

会被识别为:

引用

倾斜、加粗与分割线

倾斜与加粗的格式类似,都是*+文字+*,*号中的文字为倾斜或者加粗的文字。其中倾斜为一个*号,而加粗为两个*号, 分割线为***。例如:

*倾斜*
**加粗**
***

会被识别为:

倾斜

加粗


表格

表格的格式比较复杂,我们先看一个例子:

|line1|line2|line3|line4|
|:--|--:|:-:|---|
|111|222|333|444|
|111|222|333|444|

会被识别为:

line1

line2

line3

line4

111

222

333

444

111

222

333

444

让我们来看下具体的语法: 表头以竖线间隔开头,每个间隔内的文字都是列头。:表示当前列的对齐位置,在最左边为局左对齐,在最右边为居右对齐,如果两边各有一个,则表示居中对齐,如果没有冒号,则不需要对齐。第二列每个竖线中至少有3个字符(可以多,不可以少,冒号最多存在两个——居中对齐情况)来表示对齐的方式。

下面每个竖线内都是对应该列的内容,后面若干列如果为空可以不需要写竖线。

代码

代码有两种方式,一种是行内方式,具体请看示例。

这是一个`测试`

    这是一个测试

会被识别为:

这是一个测试

这是一个测试

从上面的例子我们可以看到,用`包裹的内容为行内的代码引用。如果是以缩进为开头的语句,则会是整行的引用。

总结

所有样式总结如下:

# 标题1
## 标题2
### 标题3
#### 标题4
##### 标题5
###### 标题6

1.(空格)有序列表1
2.(空格)有序列表2

-(空格)无序列表1
-(空格)无序列表2

[链接名](链接地址)

![](链接图片)

(>)(空格)引用——去掉大于号左右的括号

*倾斜*
**加粗**
*** 分割线

|line1|line2|line3|line4|
|:--|--:|:-:|---|
|111|222|333|444|
|111|222|333|444|

这是一个`测试`

    这是一个测试
本文参与 腾讯云自媒体分享计划,分享自作者个人站点/博客。
原始发表:2016-04-10,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 作者个人站点/博客 前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体分享计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 目的
  • 说明
  • 工具
  • 语法简介
    • 段落
      • 列表
        • 有序列表
        • 无序列表
      • 链接
        • 图片
          • 引用
            • 倾斜、加粗与分割线
              • 表格
                • 代码
                • 总结
                领券
                问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档