2018-09-19

Markdown语法简介

Markdown 是一种轻量级标记语言,它用简洁的语法代替排版,让你更加专注于书写。因为其兼容性极强,格式稳定性极高,格式转化方便等特点,已经成为非常适用于网络的书写语言,同时,Markdown支持嵌入html标签。

非技术类用户,千万不要被「标记」、「语言」吓到,Markdown的语法十分简单,常用的标记符号不超过十个,用于日常写作记录绰绰有余,不到半小时就能完全掌握。多益云markdown常用语法归纳如下:

Markdown的常用语法

一、标题

Markdown 标题支持两种形式:

1、用#标记

标题开头 加上1~6个#,依次代表一级标题、二级标题....六级标题

// #符号后面必须跟上至少1个空格才有效!
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

效果如下:

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

2、用=-标记

标题底下 加上任意个=代表一级标题,-代表二级标题,此种标记方法只有两级标题

一级标题
======

二级标题
----------

效果如下:

一级标题

二级标题


二、列表

Markdown 支持有序列表和无序列表,并且支持多级列表,下级列表标签前需加一定空格与上级首部文字对齐

无序列表使用-+*作为列表标记:

// -、+、*符号后面必须跟上至少1个空格才有效!

- Red
- Green
- Blue

+ Red
+ Green
+ Blue

* Red
* Green
* Blue

* Red
* Green
* Blue
  * blue
  * blue
  * blue

效果如下:

  • Red
  • Green
  • Blue
    • blue
    • blue
    • blue

有序列表则使用数字加英文句点.来表示:

1. Red
2. Green
3. Blue
   1. Red
   2. Green
   3. Blue

效果如下:

  1. Red
  2. Green
  3. Blue
    1. Red
    2. Green
    3. Blue

三、引用

引用采用>标记,引用中支持多级引用、标题、列表、代码块、分割线等常规语法。

标题和列表:

> #### 这是一个四级标题
> * 这是第一行列表项
> * 这是第二行列表项

效果如下:

这是一个四级标题

  • 这是第一行列表项
  • 这是第二行列表项

多级引用:

> 一级引用
> > 二级引用
> > > 三级引用

效果如下:

一级引用

二级引用

三级引用

引用代码块则需在>后边加5个空格:

>      //在>后面有 5 个空格
>      protected void onCreate(Bundle savedInstanceState) {
>          super.onCreate(savedInstanceState);
>          setContentView(R.layout.activity_main);
>      }

效果如下:

 //在>后面有 5 个空格
 protected void onCreate(Bundle savedInstanceState) {
     super.onCreate(savedInstanceState);
     setContentView(R.layout.activity_main);
 }

四、强调

一个*-代表斜体,两个*-代表加粗,三个*-代表即倾斜又加粗,~~代表删除。

**加粗文本** 或者 __加粗文本__

*斜体文本*  或者_斜体文本_

***斜粗文本***  或者___斜粗文本___


~~删除文本~~

效果如下:

加粗文本 或者 加粗文本

斜体文本 或者斜体文本

斜粗文本 或者斜粗文本

删除文本


五、图片与链接

图片与链接的语法很像,区别在一个 ! 号。二者格式:

图片:![]()    ![图片文本(可忽略)](图片地址)

链接:[]()     [链接文本](链接地址)or链接地址

例如:

这是链接:[多益云](http://yun.duoyi.com/)。

这是图片:

![多益云](https://yun.duoyi.com/images/offical/index_logo.png)

效果如下:

这是链接:多益云

这是图片:

多益云

六、代码

代码分为行内代码代码块

  • 行内代码使用 ` 标识,分别置于代码前后,可嵌入文字中
` super.onCreate(savedInstanceState);`

效果如下:

super.onCreate(savedInstanceState);

  • 代码块使用```标识,分别置于代码块上下两行

  • 代码语法高亮在 ```后面加上语言名称即可

``` java
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
}```

效果如下:

protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
}

七、表格

表格之间采用|进行分割,采用---分割表头和内容;

表格对齐格式:
默认(居左):----
居左::---
居中::---:
居右: ---:

|标题|标题|标题|
|:---|:---:|---:|
|居左测试文本|居中测试文本|居右测试文本|
|居左测试文本1|居中测试文本2|居右测试文本3|
|居左测试文本11|居中测试文本22|居右测试文本33|

效果如下:

标题 标题 标题
居左测试文本 居中测试文本 居右测试文本
居左测试文本1 居中测试文本2 居右测试文本3
居左测试文本11 居中测试文本22 居右测试文本33

八、分隔线

在一行中用三个以上的*-_*来建立一个分隔线,行内不能有其他东西。也可以在符号间插入空格。

---
***
---
___

* * *

效果如下:


以上为markdown的常用语法,快去尝试在你的工作报告中开启markdown的写作之路吧。

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

推荐阅读更多精彩内容

  • 1、通过CocoaPods安装项目名称项目信息 AFNetworking网络请求组件 FMDB本地数据库组件 SD...
    阳明AGI阅读 16,009评论 3 119
  • 我要去到一个地方 或许达到不了 我曾无比欣喜和期待过 期望我在你的心上 有人曾告诉我 你行走留下的痕迹 雨过天晴后...
    凡尘里的神仙阅读 222评论 0 0
  • 8.31日 发完新书,班主任龙老师让我给家长们讲几句。在我讲话之前,把我好一顿夸奖,听得我冷汗直冒啊,大意...
    我爱无花果阅读 701评论 5 5
  • 今天应个同事拜托去看望一个康复期的13岁男孩。因为听过描述孩子是在父母离婚后,经历了先判给爸爸,后爸爸有以养...
    青雪绿云阅读 770评论 2 4