Fork me on GitHub

MarkDown语法十分钟上手

简介
Markdown 是一种轻量级标记语言,它用简洁的语法代替排版,使我们专心于码字。它的目标是实现易读易写,成为一种适用于网络的书写语言。同时,Markdown支持嵌入html标签。

注意:Markdown使用#、+、*等符号来标记, 符号后面必须跟上 至少1个 空格才有效!

Markdown的常用语法
标题
Markdown 标题支持两种形式:

1、用#标记

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

一级标题

二级标题

三级标题

四级标题
五级标题
六级标题

2、用=和-标记

在 标题底下 加上任意个=代表一级标题,-代表二级标题

一级标题

二级标题

效果如下:

一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
列表
Markdown 支持有序列表和无序列表。

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

  • Red
  • Green
  • Blue
  • Red
  • Green
  • Blue
  • Red
  • Green
  • Blue
    效果如下:

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

  1. Red
  2. Green
  3. Blue
    效果如下:

Red
Green
Blue
引用
引用以>来表示,引用中支持多级引用、标题、列表、代码块、分割线等常规语法。

常见的引用写法:

这是一段引用 //在>后面有 1 个空格

这是引用的代码块形式    //在`>`后面有 5 个空格

代码例子:

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

一级引用

二级引用

三级引用

这是一个四级标题

  1. 这是第一行列表项
  2. 这是第二行列表项
    效果如下:

这是一段引用

这是引用的代码块形式 //在>后面有 5 个空格
代码例子:

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

二级引用

三级引用

这是一个四级标题
这是第一行列表项
这是第二行列表项
以下是分割线

强调
两个或-代表加粗,一个或-代表斜体,~~代表删除。

加粗文本 或者 加粗文本

斜体文本 或者斜体文本

删除文本
效果如下:

加粗文本 或者 加粗文本

斜体文本 或者 斜体文本

删除文本

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

图片: 图片文本(可忽略)

链接: 链接文本
链接又分为行内式、参考式和 自动链接:

这是行内式链接:ConnorLin’s Blog

这是参考式链接:ConnorLin’s Blog,其中url为链接标记,可置于文中任意位置。

链接标记格式为:[链接标记文本]: 链接地址 链接title(可忽略)

这是自动链接:直接使用<>括起来http://connorlin.github.io

这是图片:

效果如下:

这是行内式链接:ConnorLin’s Blog。

这是参考式链接:ConnorLin’s Blog,其中url为链接标记,可置于文中任意位置。

这是自动链接:直接使用<>括起来http://connorlin.github.io

这是图片:

代码
代码分为行内代码和代码块。

行内代码使用 代码 标识,可嵌入文字中

代码块使用4个空格或

1
2


这里是代码

1
2
3
4
5
6

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

``` 语言
//注意语言前面有空格
这里是代码

例如:

这是行内代码onCreate(Bundle savedInstanceState)的例子。

这是代码块和语法高亮:

1
2
3
4
5
// 注意java前面有空格
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
}

效果如下:

这是行内代码onCreate(Bundle savedInstanceState)的例子。

这是代码块和语法高亮:

// 注意java前面有空格
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
}
表格
表格对齐格式

居左::—-
居中::—-:或—–
居右:—-:
例子:

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

效果如下:

标题 标题 标题
居左测试文本 居中测试文本 居右测试文本
居左测试文本1 居中测试文本2 居右测试文本3
居左测试文本11 居中测试文本22 居右测试文本33
居左测试文本111 居中测试文本222 居右测试文本333
分隔线
在一行中用三个以上的*、-、_来建立一个分隔线,行内不能有其他东西。也可以在符号间插入空格。





效果均为一条分割线:

换行
在行尾添加两个空格加回车表示换行:

这是一行后面加两个空格 换行
效果如下:

这是一行后面加两个空格
换行

脚注(注解)
使用[^]来定义脚注:

这是一个脚注的例子^1

效果如下:

这是一个脚注的例子[1]

常用弥补Markdown的Html标签
字体

字体及字体颜色和大小
字体颜色
效果如下:

字体及字体颜色和大小
字体颜色

换行
使用html标签<br/>
换行
效果如下:

使用html标签

换行

文本对齐方式

居左文本


居中文本


居右文本


效果如下:

居左文本


居中文本


居右文本

下划线
下划线文本
效果如下:

下划线文本

That’s all, Enjoy it!

作者:ConnorLin
链接:https://www.jianshu.com/p/82e730892d42
來源:简书
著作权归作者所有。商业转载请联系作者获得授权,非商业转载请注明出处。

支持作者