MarkDown编写规范指南

时间:2021-07-25 21:29:06

Markdown 编写规范指南

简介:

Markdown的目标是实现「易读易写」,成为一种适用于网络的「书写语言」。

一份使用Markdown格式撰写的文件可以直接以纯文本发布,它的最大灵感来源其实是纯文本电子邮件的格式。

Markdown的语法由一些符号所组成,其作用一目了然。

比如:在文字两旁加上星号,看起来就像强调。

Markdown兼容HTML语法并且会将<和&等符号进行自动转换,这项特性可以让我们很容易地用Markdown写HTML code。

目录

基础语法

标题

# 这是 <h1> 标签
## 这是 <h2> 标签
###### 这是 <h6> 标签

强调

*这里文字是斜体*
_这里文字也是斜体_ **这里文字是粗体**
__这里文字也是粗体__ _你也 **可以** 这样组合他们_

实际效果:

这里文字是斜体

这里文字也是斜体

这里文字是粗体

这里文字也是粗体

你也 可以 这样组合他们

列表

无序列表

+ 条目 1
+ 条目 2
+ 条目 2a
+ 条目 2b

实际效果:

  • 条目 1
  • 条目 2
    • 条目 2a
    • 条目 2b

有序列表

1. 条目 1
2. 条目 2
3. 条目 3
+ 条目 3a
+ 条目 3b

实际效果:

  1. 条目 1
  2. 条目 2
  3. 条目 3
  • 条目 3a
  • 条目 3b

图像

![Logo](/image/logo.png)

链接1

[BaiDu](http://www.baidu.com)

链接2

我用上面那种方式进行连接,发现点击的时候是在当前页面打开的,所有就又整理了下可以新窗口打开的方法:

效果:点击打开百度首页

方法是:<a href="https://www.baidu.com/" target="_blank">点击打开百度首页</a>

引用

就像邵林说的:

> 我们活在未来
> 现在只是我们的过去

实际效果:

就像邵林说的:

我们活在未来

现在只是我们的过去

内敛代码

我想你可以在这里
使用 `<addr>` 元素

实际效果:

我想你可以在这里

使用 <addr> 元素

Github 风味的 Markdown

Github 定义了一些额外的语法,让文档编写变得更加简单和优雅,也是我们推荐使用的

语法高亮

在文章中嵌入不同语言的代码,并自动高亮关键字和语法错误

```javascript
function fancyAlert(arg) {
if(arg) {
$.facebox({div: '#foo'})
}
}
\`\`\`

实际效果:

function fancyAlert(arg) {
if(arg) {
$.facebox({div: '#foo'})
}
}

任务列表

+ [x] 这是已完成的项目
+ [ ] 这是未完成的项目

实际效果:

  • [x] 这是已完成的项目
  • [ ] 这是未完成的项目

删除线

~~删除了的项目~~

实际效果:

删除了的项目

表格

每一列通过管道符 | 分割,表头通过 - 标记即可

第一个表头 | 第二个表头
---------- | ---------
第一行第一个 | 第一行第二个
第二行第一个元素 | 第二行第二个

实际效果:

第一个表头 第二个表头
第一行第一个 第一行第二个
第二行第一个元素 第二行第二个

超链接

请为 Git 提交的 SHA-1 hash 值,issue #编号 设置超链接