Markdown入门

Markdown入门学习

Markdown简介

Markdown 是一种轻量级标记语言，它允许人们使用易读易写的纯文本格式编写文档，可以转换成有效的 HTML 文档，是由约翰・格鲁伯（John Gruber）在2004年创造。

Markdown的特点是：易读易写，方便使用。

Markdown 编写的文档不仅可以导出 HTML，而且可以导出更多格式的文档，比如 Word、picture、PDF、Epub 等文档，其编写的文档后缀为 .md, .markdown，需要使用markdown编辑器打开。

Markdown编辑器-Typora

本教程使用 Typora 编辑器来讲解 Markdown 的语法，Typora1.0版本之前是免费的，1.0版本之后收费的（不过网上都能找到都懂的版本），Typora是比较高效的，即写即得。

Typora 有两种模式，

一种是实时预览模式，写的内容会实时预览，也就是说即写即得，类似word那种，你想编写什么都会立刻显示出来的；

另一种是源代码模式 ，写的内容都包含有一些源代码，比如源代码里面，标题前面都有“#”，一个“#”代表一级标题，后面会详细讲到。

快捷键 Ctrl + / 可快速切换两种模式，也可点击软件界面下面的</>按钮。

Typora 支持 MacOS 、Windows、Linux 平台。

Typora 官网： Typora 官方中文站 (typoraio.cn)

这里还有个辅助软件，Pandoc，一个格式转换的，从Md文件转换成HTML、 Word、picture、PDF、Epub 等

Pandoc 是一种标记语言转换工具，可实现不同标记语言间的格式转换。

后面的内容都是依据Typora编辑器来学习Markdown语言的。

Pandoc 下载网址：Pandoc - Installing pandoc

1）标题

使用 # 号可表示 1-6 级标题，一级标题对应一个 # 号，二级标题对应两个 # 号，以此类推。

标题的快捷键：

Ctrl + 1 ~ 6 ，将鼠标光标放在某一行，Ctrl + 1 表示一级标题，

Ctrl + 2 表示二级标题，

依此类推，最小到六级标题。

如果某一行已经是二级标题，

再按一次 ctrl + 数字 就可以撤销标题。

实时模式

源码模式

2）目录

语法是在一对 [] 中间写上 toc 三个字母，不区分大小写，回车之后会自动生成一个目录 ，生成的目录会按缩进自动排列出文章中的所有标题，而且用鼠标点击就会自动跳转至对应的位置，非常好用，容易操作上手。

3）段落

Markdown 段落没有特殊的格式，直接编写文字就好，

段落的换行是一种是直接使用回车，

另一种是使用两个以上空格加上回车。

字体

斜体（Ctrl+I，大小写都行）

*斜体文本*

_斜体文本_

粗体（Ctrl + B，大小写都行）

*粗体文本*

_粗体文本_

粗斜体（Ctrl + B + I，大小写都行）

***粗斜体文本***

__粗斜体文本__

下划线

下划线是通过 HTML 的 <u> 标签来实现：

<u>带下划线文本</u>

带下划线文本

快捷键：Ctrl + U

删除线

添加删除线，在文字的两端加上两个波浪线 ~~ 即可

~~删除线~~

删除线

快捷键：Alt + shift + i

分隔线

在一行中用三个以上的星号、减号、底线来建立一个分隔线，行内不能有其他东西，也可以在星号或是减号中间插入空格。

下面每种写法都可以建立分隔线：

***

* *

*****

- - -

---------

高亮

四个等于号 = 之间文字的是高亮区域

==高亮(黄色背景)==

高亮(黄色背景)

脚注

脚注格式类似这样[^要注明的文本]

脚注格式类似这样[^脚注格式]

上下标

两个 ~ 之间的文字是下标，两个 ^ 之间的文字是上标

H~2~O

H₂O

m^3^

m³

4）链接

在Markdown中插入链接的语法格式如下：

[链接名称](链接地址) 或者 <链接地址>

常规用法：

这是一个[链接](https://baike.baidu.com/item/%E9%93%BE%E6%8E%A5/2665501)

这是一个链接

通过变量来设置一个链接，变量赋值在文档末尾进行

这是百度网址[baidu]1

这是百度网址baidu

（备注：这里的1一般都是标注在文章的结尾，这里是为了演示，所以都标注在当前文本下面）

链接文字后面加上一个空的方括号，这种情形下，链接标记会视为等同于链接文字，如果你要让 “百度” 链接到 https://www.baidu.com/，你可以简化成：

[百度][]

百度

然后定义链接内容：

5）图片

1. 在Markdown插入 图片的语法格式如下：

   

感叹号必须要有，没有感叹号的话就变成链接了。


2. 还可以使用网址作为变量插入到文本中

   这是一幅风景画 pic

   这种不能实时显示，需要点击链接才能看到。

3. 这种图片插入通常不能改变图片的大小，常用的图片插入方式是下面这种：使用普通的<img> 标签

   <img src=“https://s1.ax1x.com/2022/09/05/vTdQBD.jpg” style=“zoom: 25%;” />)

   

   以上是Markdown 文档引入图片的三种方式，

   但是Markdown 只能引用外部图片，本地的图片引用后，只可以在本地查看，上传到博客等网站后将无法显示出来，因此需要一个图床来解决这个问题（图床有好多种，可以网上搜索一下进行尝试）。

   而且很难实现图文混排，比如文字环绕图片等效果。

6）公式

当需要插入数学公式时，可以使用两个或四个美元符 $$ 包裹 TeX 或 LaTeX 格式的数学公式来实现。

$ \sqrt{4} $

$$\sqrt{4}$$

这里有一个网址：在线LaTeX公式编辑器-编辑器 (latexlive.com)

可以直接编写后，生成代码，然后复制到Typora中来，可以减少记忆很多公式等。

7）列表

列表分为无序列表和有序列表

1. 无序列表的语法格式

   无序列表使用星号(*)、加号(+)或是减号(-)作为列表标记，这些标记后面要添加一个空格，再填写内容

   • * 无序

   • • +无序

     • • - 无序

2.有序列表的语法格式

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

1. 2
2. 3

8）区块

区块语法格式

在段落开头使用 > 符号 ，后面紧跟一个空格符号

>

区块使用方法

另外区块是可以嵌套的，一个 > 符号是最外层，两个 > 符号是第一层嵌套

>

>>

区块使用方法

方法一

方法二

区块可以和列表嵌套使用

9）表格

Markdown表格的语法格式（快捷键：Ctrl + T）

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

语法格式如下：

| 表头 | 表头 |

| ---- | ---- |

| 单元格 | 单元格 |

中左对齐	居中	右对齐
单元格	单元格	单元格
单元格	单元格	单元格
单元格	单元格	单元格

10）代码

一些编程语言的代码需要用Markdown文档来写的话，里面的库函数需要单独高亮起来，在Markdown中一个函数或片段的代码可以用反引号包起来（`）

print("hello,Markdown") 反引号包起来的

print(“hello,Markdown”) 直接编写的

代码块需要三个反引号（```）

使用反引号定义代码块，并定义高亮，高亮的话是需要在反引号后面加上编程语言的名字

```java

pubic static void main(String[] arg) {

​ System.out.println(“hello Markdown”)

}

```

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

11）转义字符

Markdown 有很多特殊符号，如果需要显示特殊符号则需要用转义字符，Markdown 用反斜杠"\"转义特殊字符。

12）注释

Markdown文档的注释可以使用 <!-- 文本内容 --> 方式。

<!-- 这是一段注释！ -->