Markdown语法快速入门学习笔记

文章目录

  • Markdown简介
  • 语法入门
    • 标题
    • 文本强调
    • 列表
      • 有序列表
      • 无序列表
      • 列表间的组合
    • 链接
    • 代码和语法高亮
      • 行内代码
      • 语法高亮
    • 引用
    • 水平分割线
    • 补充
  • 总结

Markdown简介

Markdown是一种轻量级的标记语言,它的创始人是John GruberMarkdown的语法特点是比较简洁易懂的,它的理念是让文档更加的容易读写和更改,我觉得人们在数十分钟内即可快速入门Markdown。以下内容是我的一个较为简单的学习总结。

语法入门

标题

Markdown最高支持六级标题,其语法格式为在标题文字前加入#和空格。在Typora里使用快捷键Ctrl+1可以实现一级标题的标注,余下的二级、三级等标题快捷键以此类推即可。

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

需要注意的是,当标题级别超过六级,即前方使用七个#,此时的语法已经不能再标注标题,输入的#######和正常的正文文本没有区别。

对于一级和二级标题,还可以使用如下方式进行显示。

一级标题
====

二级标题
---

文本强调

Markdown通过使用*_包围文本来实现文本的强调加粗和斜体显示,具体语法如下:

*斜体* 或者 _斜体_
**加粗文本** 或者 __加粗文本__
***粗斜体文本*** 或者 ___粗斜体___

这里的*_和文本之间如果是有空白,那么它们不会起到应有的效果。如果确实需要在文本前后加入星号或者底线,可以考虑使用转义符进行实现。转义字符的用处在于,它保留了字符本该有的意义。

\*这是一段前后有星号的文字\*

列表

列表分为有序和无序两种,列表之间还可以进行组合嵌套。

有序列表

1. 列表项1
2. 列表项1
3. 列表项1

在这里需要注意的是,在数字标注1.和后方列表项需要有一个空格进行隔开才能实现列表项,后面的无序列表的标注符号和列表项亦是如此。

无序列表

无序列表前面的标注符号可为*、+和-。

* 列表项1
* 列表项2

+ 列表项1
+ 列表项2

- 列表项1
- 列表项2

以上三种语法在编辑器中的结果均为:

  • 列表项1
  • 列表项2

列表间的组合

* 产品介绍
    下方的子项需要以一个制表符或者4个空格缩进之后再书写列表项前方标注
    
* 产品功能    
	1. 功能1
    2. 功能2

Markdown编辑器中结果为:

  • 产品功能
    1. 功能1
    2. 功能2

列表标注避免歧义:

当首行内容是以日期或者数字起始如:2015. 公司年度目标规划,此时为了避免其被转化为有序列表,我们可以在“.”前面加上反斜杠即转义字符来避免歧义。

2015\. 公司年度目标规划

链接

[bing](https://www.bing.com/ "必应")
  • [ ]中的文本内容表示最终显示在编辑器里的文字

  • 括号中的https://www.bing.com/是要跳转到的目标网页

  • “必应”表示鼠标悬停在此超链接时显示的文字

此时插入链接的效果如下:

bing

注:
Markdown本身语法不支持连接在新的页面打开,csdn页面点击后网页还是打不开,这里如果要实现跳转,可以使用HTML语言来实现同样的效果。语法如下:

<a href="https://www.bing.com/" target='_blank'>binga>

使用HTML添加的链接即是可以实现跳转的了:
bing

代码和语法高亮

行内代码

这是一篇`markdown`的学习笔记。

结果是:

这是一篇markdown的学习笔记。

如果需要高亮的内容本身包含" ` ",则是可以这样来写:

`` `这里` ``

语法高亮

Markdown支持多种语言的语法高亮,如需要在文本中加入代码块,可使用如下示例语法:

​```python
import pandas as pd
​```

​```html
Syntax Highlighting
​``` ​```java println('Hello world!') ​```

以上语法高亮效果如下:

import pandas as pd
<div>Syntax Highlightingdiv>
println('Hello world!')

Markdown支持的代码高亮远不止这些,其余的代码高亮功能还需要读者自行尝试,按照类似的方法,变换语法名称即可。

引用

Markdown语法中,在需要引用的文字前加入>即可实现引用效果。语法示例如下:

> 这是一段很长的文字。

结果如下:

这是一段很长的文字。

Markdown的引用可以实现嵌套效果,语法如下:

> 这是第一层文字。
>> 这是第二层文字。

结果如下:

这是第一层文字。

这是第二层文字。

水平分割线

Markdown可使用*或者是-来实现一条“华丽的分割线”,具体语法如下:

***
* * *
- - -

结果均为一条分割线,如下所示:


补充

Markdown其实也支持传统的HTML标签,我们在引用的时候也可以写成:

<blockquote>这是使用html语法实现的引用效果blockquote>

我们可以看到,这里使用HTML语法实现的效果是相同的:

这是使用html语法实现的引用效果

总结

这些是本人对Markdown语法的学习笔记和总结,也是本人的第一篇博客。多有不足之处还请各位读者包涵。

你可能感兴趣的:(Markdown)