Markdown 编辑器指南

一直觉得博客园默认的编辑器不好用,后来了解了Markdown,并且博客园也支持Markdown标记,所以写篇博客总结下。


一、认识 Markdown

Markdown 是一种用来写作的轻量级「标记语言」,它用简洁的语法代替排版,而不像一般我们用的字处理软件 Word 有大量的排版、字体设置。它使我们专心于码字,用「标记」语法,来代替常见的排版格式。例如此文从内容到格式,甚至插图,键盘就可以通通搞定了。

优点:
1、因为是纯文本,所以只要支持Markdown的地方都能获得一样的编辑效果,可以让作者摆脱排版的困扰,专心写作。
2、操作简单。比如:Word编辑时标记个标题,先选中内容,再点击导航栏的标题按钮,选择几级标题。要三个步骤。而Markdown只需要在标题内容前加#即可。

缺点:
1、需要记一些语法(当然,是很简单。五分钟学会)。
2、有些平台不支持Markdown编辑模式。


二、Markdown 基本语法

2.1 标题

在想要设置为标题的文字前面加#来表示,一个#是一级标题,二个#是二级标题,以此类推。支持六级标题。

示例:

# 这是一级标题
## 这是二级标题
### 这是三级标题
#### 这是四级标题
##### 这是五级标题
###### 这是六级标题

由于我重新设置了博客园的标题相关CSS,显示的标题不再是博客园默认的样式,所以这里就不展示效果了。

注:标准语法一般在#后跟个空格再写文字,但也有些网站的编辑器不加空格也行。


2.2 字体

  • 加粗

    要加粗的文字左右分别用两个*号包起来

  • 斜体

    倾斜的文字左右分别用一个*号包起来

  • 斜体加粗

    要倾斜和加粗的文字左右分别用三个*号包起来

  • 删除线

    要加删除线的文字左右分别用两个~~号包起来

示例:

**这是加粗的文字**
*这是倾斜的文字*`
***这是斜体加粗的文字***
~~这是加删除线的文字~~

效果:

这是加粗的文字
这是倾斜的文字`
这是斜体加粗的文字
这是加删除线的文字


2.3 引用

在引用的文字前加>即可。引用也可以嵌套,如加两个>>,加三个>>>,n个...;貌似可以一直加下去,但没神马卵用。

示例:

>这是引用的内容
>>这是引用的内容

效果:

这是引用的内容

这是引用的内容


2.4 分割线

三个或者三个以上的 - 或者 * 都可以。

示例:

---

效果:



2.5 图片

语法:

![alt 属性文本](图片地址 "可选标题")
  • 开头一个感叹号 !
  • 接着一个方括号,里面放上图片的替代文字
  • 接着一个普通括号,里面放上图片的网址,最后的"可选标题"是当鼠标移到图片上时显示的内容

示例:

![RUNOOB 图标](http://static.runoob.com/images/runoob-logo.png "RUNOOB")

效果:

RUNOOB 图标


2.6 链接

语法:

[链接名称](链接地址 "链接title")
title可加可不加

示例:

[博客园](https://www.cnblogs.com/)

效果:

博客园


注:Markdown本身语法不支持链接在新页面中打开,如果想要在新页面中打开的话可以用html语言的a标签代替。

<a href="超链接地址" target="_blank">超链接名</a>
 
## 示例
<a href="https://www.cnblogs.com/" target="_blank">博客园</a>

2.7 列表

Markdown 支持有序列表和无序列表,并且支持列表嵌套。

无序列表

无序列表使用星号(*)、加号(+)或是减号(-)作为列表标记:

- 列表内容
+ 列表内容
* 列表内容
 
## 注意:- + * 跟内容之间都要有一个空格

效果:

  • 列表内容
  • 列表内容
  • 列表内容

有序列表

有序列表使用数字并加上 . 号来表示,如:

1. 列表内容
2. 列表内容
3. 列表内容
 
## 注意:序号跟内容之间要有空格

效果:

  1. 列表内容
  2. 列表内容
  3. 列表内容

列表嵌套

列表嵌套只需在子列表中的选项添加四个空格即可:

1. 第一项:
    - 第一项嵌套的第一个元素
    - 第一项嵌套的第二个元素
2. 第二项:
    - 第二项嵌套的第一个元素
    - 第二项嵌套的第一个元素

效果:

  1. 第一项:

    • 第一项嵌套的第一个元素

    • 第一项嵌套的第二个元素

  2. 第二项:

    • 第二项嵌套的第一个元素
    • 第二项嵌套的第一个元素

2.8 表格

Markdown 制作表格使用 | 来分隔不同的单元格,使用 - 来分隔表头和其他行。

示例:

|  表头   | 表头  |
|  ----  | ----  |
| 单元格  | 单元格 |
| 单元格  | 单元格 |

效果:

表头 表头
单元格 单元格
单元格 单元格

2.9 代码

单行代码

单行代码:代码之间分别用一个反引号包起来。

示例:

`代码内容`

效果:

代码内容


代码块

代码块:代码之间分别用三个反引号包起来,且两边的反引号单独占一行。

示例:

​```
int main (int argc, char *argv[])
{
    return 0;
}
​```

效果:

int main (int argc, char *argv[])
{
    return 0;
}

参考:

菜鸟教程-Markdown 教程

Markdown基本语法


posted @ 2018-12-14 15:22  fengMisaka  阅读(1215)  评论(0编辑  收藏  举报