华企号 后端开发 MarkDown入门教程

MarkDown入门教程

Markdown的创始人是John Gruber,Markdown作为一种轻量级的「标记语言」,它使我们专心于码字,用「标记」语法,来代替常见的排版格式.


➢段落
一段内容当做一个段落来显示,则需要保证该段内容上方及下方至少各有一个空行(空行含义:某一行只包含空白便会被视为空行)


如何对段落进行换行?
不得不说段落这里是比较绕的哈,了解就行

  1. 使用两个以上空格键加上回车{敲个回车键}选择题提示:MarkDown中使用回车就可以进行段落的换行为错误说法
  2. 在段落后面使用一个空行来表示重新开始一个段落{敲2个回车,第二个回车写内容代表另起一段}
  3. 在第一行的末尾添加br标签进行换行,就会显示成两段内容{添加br敲回车另起一段}

强调说明:
Markdown使用星号*和下划线_作为标记强调字词的符号.


斜体

  • 在Markdown中,将内容用*或_包裹起来,包围的字词会被转成用标签包围,会显示成斜体
  • 如果要在文字前后直接插入普通的星号可以用反斜杠 *
  • 如果要在文字前后直接插入普通的_插入下划线 _
  • 注意符号连接在一起

粗体

用两个*或_包起来就会转换成粗体


删除线

使用两个 ~ 来给内容加上删除线,举例:这个内容是被删掉的


下划线

输入3个星号*或者hr标签


标题{Markdown支持两种标题的语法Setext和atx形式}


Setext形式是用底线的形式,利用= (一级标题)和- (二级标题),效果等同h1-h2

举例:注意事项{Setext形式的标题至少需要3个以上的=或_才可以正常显示为标题样式}

标题1
=====
标题2
-------

Atx形式标题,则是在行首插入1到6个#(最多支持6级标题)对应到h1-h6
举例:

# 标题1
## 标题2

➢链接
Markdown支持两种形式的链接语法:行内和参考形式链接.不管是哪一种,链接的文字都是用[方括号]来标记.

行内形式的链接

在方块括号后面接括号并插入网址链接即可,如果你还想要加上链接的alt提示文字,只要在网址后面,用双引号把alt文字包起来即可.

其格式为内容

例如个人博客


参考形式链接使用另外一个方括号接在链接文字的括号后面,而在第二个方括号里面要填入用以辨识链接的标签
可以使用[内容]:http_url@提示的形式添加一个超链接

注释:个人学习参考形式链接不推荐

↳学过Markdown参考形式图片更正下

可以使用参考样式的方式添加一个链接,其结构为 [内容][1] + [1]: http_url “alt 提示” 的组合


举例:

[鬼牛阿飞][wiki]

[wiki]: http://www.dhnblog.cn/ "鬼牛阿飞个人博客"

代码:

[鬼牛阿飞][]

[鬼牛阿飞]: http://www.dhnblog.cn/

链接的定义可以放在文档中的任何一个地方,建议直接放在链接出现段落的后面,也可以把它放在文档最后面.


图片

行内形式图片的语法格式为

![Alt text](/path/to/img.jpg "Optional title")

Alt text

注释:刚把百度里面的图片复制修改下,在部分内容编辑器可能提示为:[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-S0buDZ6F-1670403330252)(/path/to/img.jpg “Optional title”)]

参考形式图片的语法格式

![Alt text][id]

[id]: url/to/image  "Optional title attribute"

举例:

Git 课程


列表:Markdown支持有序列表、无序列表和任务列表 三种形式的列表

无序列表使用 * 、 + 或是 – 作为列表标记{符号空格/文字}

有序列表则使用小写数字接着一个英文句号{数字.空格/文字}

当在行首出现数字-句点-空白的内容时,Markdown 会将其当做一个列表进行展示,要避免这样的状况,可以在句点前面加上转义符 
1987. What a great season.
列表也可以进行嵌套或者与其他 Markdown 内容

任务列表的语法格式为 – [ ] text,其中 [ ] (带空格的中括号)表示未完成的任务,x 表示已经完成的任务

代码:

- [x] 起床
- [x] 吃饭
- [ ] 工作
- [ ] 睡觉

效果:


分隔线

可以在一行中用三个或以上的、-、_来创建一个分隔线,行内不能有其他东西.你也可以在星号中间插入空白


引用

Markdown 使用 email 形式的区块引用,我们在要引用内容每行的最前面加上 > ,就可以在 Markdown 文档中创建一个区块引用:

  1. 允许只在整个段落的第一行最前面加上 >
  2. 区块引用可以有级别(例如:引用内的引用),只要根据级别加上不同数量的 >

代码:

> Perl语言的发明人Larry Wall说,好的程序员有3种美德: 懒惰、急躁和傲慢(Laziness, Impatience and hubris).
>
> > 程序员有三种美德:懒惰,急躁和傲慢. —— **Larry Wall**
>
> 懒惰,会使得你花大力气去避免消耗过多的精力.它敦促你写出节省体力的程序,同时别人也能利用它们.为此你会写出完善的文档,以免别人问你太多问题.
急躁,当你发现计算机懒洋洋地不给出结果.于是你写出更优秀的代码,能尽快真正的解决问题.至少看上去是这样.
傲慢,极度的自信,使你有信心写出(或维护)别人挑不出毛病的程序.
>

效果:

Perl语言的发明人Larry Wall说,好的程序员有3种美德: 懒惰、急躁和傲慢(Laziness, Impatience and hubris).

程序员有三种美德:懒惰,急躁和傲慢. —— Larry Wall

懒惰,会使得你花大力气去避免消耗过多的精力.它敦促你写出节省体力的程序,同时别人也能利用它们.为此你会写出完善的文档,以免别人问你太多问题.
急躁,当你发现计算机懒洋洋地不给出结果.于是你写出更优秀的代码,能尽快真正的解决问题.至少看上去是这样.
傲慢,极度的自信,使你有信心写出(或维护)别人挑不出毛病的程序.

3.引用的区块内也可以使用其他的 Markdown 语法,包括标题、列表、代码块等{支持嵌套}


代码块

行内代码的格式很简单,只需要使用两个 ` 将代码内容包裹起来即可


缩进显示代码{一个代码块会一直持续到没有缩排的那一行(或是文档结尾)}
缩排 4 个空白{空格}或是 1 个 tab 就可以

在代码块里面, & 、 < 和 > 会自动转成 HTML 特殊字符,这样的方式让你非常容易使用 Markdown 插入 HTML 的原始示例代码
就是说在Markdown代码块里面,不用打特殊字符,比方>,原本是>现在直接输入>就可以了.

高亮显示代码段

除了缩进显示代码段之外,Markdown 还支持高亮显示的代码段,创建高亮显示的代码段时,将代码段由带有三个反引号( “` )的行围起来,并在第一个围栏的末尾标识上语言类型即可

	```javascript
	// A highlighted block
	var foo = 'bar';
	```
```javascript
// A highlighted block
var foo = 'bar';
```

当然也可以不指定语言类型{如果“`的这个并排显示,效果等于行内代码块“,不过测试题目中提示该语法不正确}

	```
	echo "Hello"
	```
```
echo "Hello"
```

Diff 语法{需要注意的是,如果差异内容中包 ,请确保使用反斜杠 来转义每个反引号 ,否则差异突出显示将无法正确呈现.}

	```diff
	var foo = 'bar';
	+ var x = 200;
	* var x = 100;
	```
```diff
var foo = 'bar';
+ var x = 200;
* var x = 100;
```

更正下如何转义?示例:

`

否则展示就是这样式的:Diff 语法{需要注意的是,如果差异内容中包 ,请确保使用反斜杠 来转义每个反引号 ,否则差异突出显示将无法正确呈现.}

原本内容其实是:Diff 语法{需要注意的是,如果差异内容中包 `,请确保使用反斜杠 来转义每个反引号` ,否则差异突出显示将无法正确呈现.}

➢表格

单元格展示为

|  |  |
|--|--|
|  |  |

举例为

header1 header2 header3
cell 4 cell 5 is longer sadasdas
dsasad asdsada cell 6 is much longer than the others,
but that’s ok. It will eventually wrap
the text when the cell is too
large for the display size.
cell7 cell9

代码为

| header1 | header2 |header3|
|---|---|---|
|cell 4 | cell 5 is longer |  sadasdas |
|dsasad  | asdsada | cell 6 is much longer than the others, <br>but that’s ok. It will eventually wrap<br> the text when the cell is too<br> large for the display size. |
|cell7||cell9|

语法要求

  1. 第一行包含表头,并用”竖线”( | )分隔
  2. 第二行将标题与单元格分开,并且必须包含三个或更多破折号
  3. 第三行以及随后的任何行均包含单元格值

作者: 华企网通王鹏程序员

我是程序员王鹏,热爱互联网软件开发和设计,专注于大数据、数据分析、数据库、php、java、python、scala、k8s、docker等知识总结。 我的座右铭:"业精于勤荒于嬉,行成于思毁于随"
上一篇
下一篇

发表回复

联系我们

联系我们

028-84868647

在线咨询: QQ交谈

邮箱: tech@68v8.com

工作时间:周一至周五,9:00-17:30,节假日休息

关注微信
微信扫一扫关注我们

微信扫一扫关注我们

关注微博
返回顶部