Markdown介绍

我今天指定是不行了
145 阅读6分钟

Markdown介绍

Markdown的官方解释可以上网查询。 但在我看来，实际上就是减少鼠标的点击以及语法统一化。减少鼠标的点击，实际上就是快捷键，比如加粗，原本你需要在选中被加粗的文本，然后选择加粗。统一化，比如我感觉每一个软件对插入图片的方式都不同，比如offic与wps。 我这个文档就是由Markdown写的，我用Markdown语法去写Markdown介绍文档，这算不算我介绍Markdown成功了？

前置步骤

创建md文件

在电脑上，点击右键是不是没有新建markdown文件的选项，Markdown的文件通常以.md或.markdown为扩展名(对的，你想的没错，就是那个md)，你只需要在电脑上先创建一个TXT文本文档，然后将其后缀改为.md即可。

编辑查看工具

在md的工具选择方面，有许多的选择，记事本其实都行。但我推荐所见即所得的工具，这样书写效果才明显，之前我使用最多的是Typora，但是后来它1.0版本之后要收费，只可使用0.9版本的，但是我这个人就是不喜欢旧的，所以我开始使用另一个工具Obsidian：obsidian.md/download。

基础语法

在这里我只会介绍我日常使用的最多的语法，其他未介绍的语法可以去菜鸟教程上查看。主要是没经常使用的也没必要去学习，到了该用的时候，就去学习就行了。

日常文字输入

Markdown的输入与Word文档一样的，只需要直接输入内容，就行了。

加粗

文本加粗，只需要在需要加粗文本两边添加两个*星号即可：

加粗加粗加粗加粗加粗加粗加粗**加粗**加粗加粗加粗加粗加粗

现在这个的效果是

加粗加粗加粗加粗加粗加粗加粗加粗加粗加粗加粗加粗加粗

斜体

斜体只需在需要斜体的文本两边添加一个*星号即可：

斜体的内容*斜体*斜体的内容

呈现效果 斜体的内容斜体斜体的内容

这里的*是可以叠加的，就像叠甲。我要一个又是粗体又是斜体的怎么搞，三个*撒。

是可以叠加的***叠甲***

呈现效果 是可以叠加的叠甲

标题

Word中有一级标题，二级标题等这样的分层，markdown也有(最高6级)，而且这是我个人觉得最能体现语法简洁的地方，只需要使用#号即可创建标题。 一级就是前面加上一个*,二级就是前面加上两个*。 注意：井号后面有空格哦

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

线条

删除线

添加删除线，需要加删除线的文本两边添加两个~波浪线。

这是一个测试，~~测试删除线的使用~~

呈现效果 这是一个测试，测试删除线的使用

下划线

在Markdown的语法中没有下滑线，但是Markdown支持在文本中嵌入HTML标签以及样式，是不是感觉有点诡异。

<u>2121212</u>

呈现效果： 2121212

分割线

分割线，在单独一行使用连续三个及以上的*星号或者-号。我比较推荐---。

***
或者
---

呈现效果

文本高亮

使用两个=等号，高亮效果不同的编辑器呈现效果会不一样。

==我是高亮部分==

呈现效果 ==我是高亮部分==

代码块

用上下三个连续的 ` 符号来添加代码块。

public ActionResult checkMsgByTaskId(@PathVariable("flowCode") String flowCode) {  
    String result = publicService.checkMsgByTaskId(flowCode);  
    return AcResult.success(result);  
}

可以根据你代码的语言来渲染。在上面添加语言名称，我写的是java，这就表明了表示这个代码块是一段Java代码，这样方便它渲染。

注意： 代码块中的所有内容都会被认为是代码，不可以嵌套其他Markdown语法。

链接

在Word中，插入文件有两种常用的，插入超链接与插入图片

[显示文字](地址)

呈现效果 百度

图片

插入图片,语法如下：

![显示文字](图片地址)

Markdown文档是纯文本格式，不能插入图片，只能填写这个图片的位置，作为加载进来，因此我们使用的是本地图片地址或是网络图片地址。下面是“哥哥”的图片。

![](https://pic4.zhimg.com/v2-2eb598cdd000376bf0f6027a7bb326c7_r.jpg)

呈现效果：

图片插入后，大小由编辑器决定，一般是占满宽度，我们无法主动修改图片的大小。如果想要修改大小，请使用htnl。

现在你把你的笔记分享给别人，实际上就是一个md文件加上一个图片文件夹，这样是不是感觉不方便，多了一个图片文件夹。我们可以将图片放在一个服务上，将每个图片作为链接，就像上面“哥哥”的图片，就是一个网络图片。这样我们就可以减少这个本地图片文件夹。 实际上图床的选择是比较关键的，你把图片上传上去，万一有一天这个官方挂了，那你的图片就保不了，所以我觉得有些时候出点钱，无所谓。比如阿里的oss等。 我之前写过一个免费的图床。七牛云图床搭建

日常不常用

表格

在我看来，Markdown创建表格的语法显得有点复杂。

| 列名一 | 列名二 | 列名三 |
| --- | --- | --- |

呈现效果：

列名一列名二列名三

接着我们来编写表体，格式与表头是一样的，并且可以一直往下写：

列名一列名二列名三
测试一测试二测试三
测试一测试二测试三

Markdown的表格支持内容的对齐调整，只需要使用:冒号调整分割线即可：

| 名称 | 年龄 | 性别 |
| :--- | :---: | ---: |

其中：

  • :--- 为左对齐
  • ---: 为右对齐
  • :---: 为居中对齐

比如将列名一，列名二 居左对齐：

| 列名一 | 列名二 | 列名三 |
| :--- | :--- | --- |

列表

列表分为有序列表与无序列表

无序列表

创建一个无序列表，我们只需要使用-作为前缀，注意需要空格：

- 这是第一行
- 这是第二行

呈现效果

  • 这是第一行
  • 这是第二行
有序列表

直接使用数字的123来表示，首先输入数字然后添加.小数点作为前缀，注意添加空格：

1. 这是第一项
2. 这是第二项

呈现效果

  1. 这是第一项
  2. 这是第二项

有时候层级比较多的时候，可以来个嵌套。

就是TAB健。

  1. 这是第一项
    1. 这是第一项的第一个
    2. 这是第一项的第二个
  2. 这是第二项

勾选框

勾选框样式:

* [ ] 未勾选
* [x] 勾选

呈现效果

  • 未勾选
  • 勾选

引用

引用的内容是需要特别显示的。Markdown的引用就是引用块。

> 我被引用了

呈现效果：

我被引用了

HTML标签

之前就说了Markdown可以使用部分HTML标签。 通过这个我们可以调整图片的大小，我一般就只用了这个。

avatar
文章
阅读
粉丝