初识Markdown

1.1 Markdown简介

Markdown是一种轻量级标记语言,创始人为约翰·格鲁伯(John Grruber)。它允许人们”使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML(或者HTML)文档。吸收了很多在电子邮件中已有的纯文本标记的特性。

广泛应用于:Stack Overflow,GitHub,Bitbucket等网站,常见的个人博客也大量使用Markdown。

1.2 基本语法

我们通过1.1Markdown简介中了解到了Markdown的由来,下面介绍一下Markdown的基本语法:

1.2.1 超链接&图片&代码&引用

超链接
在markdown语法中,通过[]()语法来构成链接其中[]中为超链接的文字,()中是点击时跳转的URL链接。

效果:

谷歌
语法:

[谷歌](https://www.google.com.hk/)   

图片
图片的引用与超链接语法由很大的相同点,其语法由![]()构成,其中!为固定语法。[]表示图片的描述信息,()表示图片的引用地址,支持绝对路径与相对路径。
效果:

谷歌
语法:

![谷歌](http://file.digitaling.com/eImg/uimages/20150902/1441163163463249.gif)

代码

由`开始,由`结束。中间写代码

单行语法:

`System.out.println("hello world")`

单行代码效果:

System.out.println("hello world")

多行代码块语法:

    ```MarkDown
        public static void main(String[] args){
            System.out.println("hello world")
        }

多行代码块效果:

```Markdown
    public static void main(String[] args){
        System.out.println("hello world")
    }

引用

在段落的前面使用>符号,就可以将这段内容设置为引用的内容。

语法:

>代码引用

效果:

代码引用

1.2.2 无序列表& 有序列表

无序列表语法由:- 列表名称实现,注意-与列表名称中一定要有空格,否则不能正确解析:

(没空格): -列表。

(有空格):

  • 列表1

无序列表

效果:

  • 列表1
  • 列表2
  • 列表3

语法:

- 列表1
- 列表2
- 列表3

有序列表

有序列表语法由:阿拉伯数字. 列表名称实现,注意阿拉伯数字.与列表名称中一定要有空格,否则不能正确解析:

(没空格): -列表。

(有空格):

  1. 列表1

效果:

  1. 有序列表1
  2. 有序列表2
  3. 有序列表3

语法:

1. 有序列表1
2. 有些列表2
3. 有些列表3

1.2.3 换行&空格&标记

换行
段落中换行可以在前一行行尾中加入两个空格即可换行。
空格

使用 或&#8194
使用 或&#8195
使用 或 

标记

标记语法由==标签开始,由==标签结束组成,在开始标签==与结束标签==之间写标记的内容
效果:
  ==标记==
语法:

==标记==

1.2.4 加粗&斜体&下划线&删除线

加粗
加粗语法由:开始标签,与结束标签构成,在开始标签与结束标签之间填写需要加粗的内容即可。如下所示:

效果:
加粗

语法: **加粗**

斜体

斜体语法由:开始标签*,与结束标签*构成,在开始标签与结束标签之间填写斜体的内容即可。(PS:斜体与加粗语法极其相似,切记不要弄混,粗体标签开始与结束标签均为两个星*,斜体则为一个构成)如下所示:

效果: 斜体

语法:*斜体*

斜体加粗

斜体加粗其实是一个斜体与加粗语法的组合,开始标签与结束标签均由三个星:***组成。

效果:斜体加粗

语法:***斜体加粗***

删除线

删除线的语法由~~开始标签~~与结束标签构成,在开始标签与结束标签中间为需要有删除线的内容构成。

效果:
删除线

语法:~~删除线~~

下划线

下划线的语法由:开始标签:++与结束标签++构成,在开始标签与结束标签中间为需要有下划线的内容构成。

效果:
  ++下划线++

语法:++下划线++

1.2.5 标题&分割线

标题

其中标题有六中标题类型,分别为:一级标题,二级标题,三级标题,四级标题,五级标题,六级标题。
其语法由: #+空格+标题名称。
效果:

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

语法:

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

PS:标题分为六级,超过六级则不能被正确解析,如:

效果:

####### 七级标题

语法:

####### 七级标题

分割线

分割线由---构成,

效果:


语法:---

1.2.6 复选框

待办事项
待办事项语法由:- []构成:

  1. 未选中代码则为- [ ]在[]中添加空格。
  2. 已选中代码则为- [x]在[]中添加x。
  3. 如果需要有层级结构,在-前按tab键即可。如下所示:

效果:

  • [x] 已完成项目
  • [x] 已完成事项1

语法:

- [x] 已完成项目
    - [x] 已完成事项1

完整案例如下:

效果:

  • [x] 已完成项目
  • [x] 已完成事项1
  • [x] 已完成事项2
  • [x] 未完成项目
  • [ ] 未完成项目1
  • [ ] 未完成项目2

语法:

- [x] 已完成项目
    - [x] 已完成事项1
    - [x] 已完成事项2
- [x] 未完成项目
    - [ ] 未完成项目1
    - [ ] 未完成项目2 

1.3 Markdown常用工具

支持Markdown的工具有很多,这里推荐几个个人觉得比较好的工具(有读者觉得好的Markdown工具,也可以留言一起学习):

  • GitHub 可以GitHub中开源项目的评论区,readme文件中均可使用Markdown语法。
  • MarkdownPad Windows上的全功能Markdown编辑器。
  • 有道笔记 网页版,PC端,移动端全面支持Markdown语法。
  • Haroopad 支持Windows,Linux,Mac OS多个操作系统解决方案

1.4 参考链接

维基百科 维基百科Markdown词条

1.5 小结

该篇文章从Markdown简介,Markdown基本语法,Markdown常用工具三个方面介绍了Markdown,之所以说是Markdown的基本语法,因为Markdown还有更好,更强大的支持,如:流程图,时序图等,这里留点悬念,将在下篇文章中进行详细介绍。

最后修改:2018 年 11 月 13 日
如果觉得我的文章对你有用,请随意赞赏