Markdown基础与进阶语法

文章目录

- 一、Markdown介绍
- - （一）、Markdown语言
  - （二）、Markdown编辑器
  - （三）、Markdown与HTML
- 二、Markdown语法
- - （一）、基础语法
  - （二）、进阶语法
  - - 1、文本选择性隐藏
    - 2、文章内部跳转
    - 3、添加键盘按键图标
    - 4、添加表情包
    - 5、隐藏文字
    - 6、为链接添加Title提示
    - 7、自动生成目录
    - 8、换行
    - 9、首行缩进
- 三、Reference

一、Markdown介绍

（一）、Markdown语言

markdown是一种轻量级标记语言，我们可以通过该语言快速编写易读的纯文本格式文档，Markdown 编写的文档后缀为 .md, .markdown，Markdown 编写的文档可以导出 HTML 、Word、PDF、Epub 等多种格式的文档。

（二）、Markdown编辑器

有多种编辑器可以编写Markdown文档，如Typora、语雀、Sublime Text等。

（三）、Markdown与HTML

Markdown与HTML一样都是标记语言，它只是单纯用来书写的语言，可以快速地书写出简洁、富有层次结构的文档，除了Markdown中基本的语法，它还可以使用HTML语法，不需要额外标注HTML或是Markdown语法，如HTML中的块级元素、div、p、span、img标签等。

但是要注意的是，在HTML区块标签内的Markdown格式语法不会被处理，如使用int a = 1; 不会被处理为代码插入。

二、Markdown语法

（一）、基础语法

基础语法很多文档中有，这里就不再赘述，给出参考的文档：

(360条消息) Markdown 语法手册（完整整理版）_witnessai1的博客-CSDN博客_markdown语法

(361条消息) Markdown 基础操作 | 高级操作大全+Typora常用快捷键_Li Yikou的博客-CSDN博客_markdown 隐藏文字

(372条消息) Markdown语法文档，Markdown教程，Markdown语法大全，_伊人夕岸_的博客-CSDN博客_markdown语法文档

（二）、进阶语法

1、文本选择性隐藏

我们可以选择性地隐藏一些段落、代码，如隐藏一个问题的答案可以通过该种方式，阅读者可以手动展开隐藏的段落。

通过<details>和<summary>来选择性地隐藏部分段落，summary代表非隐藏文本，下面空白处就是隐藏的文本。下面是markdown文本中编写的内容，如下所示：

<details>
    <summary>
        非隐藏内容
    </summary>
    <br>
    隐藏内容
</details>

下面是隐藏的效果：

在这里插入图片描述

可以应用在一问一答的展示形式上，如下所示：

在这里插入图片描述
但是，CSDN上好像无法显示该效果！！！

2、文章内部跳转

我们在写文档时，可能会引用到当前文档下的其他内容，因此需要快速定位到指定的位置，要实现该种操作一共分为两步。

第一步埋下锚点：

 <span id="point">跳转锚点</span>

注意，typora中由于版本不同可能不能使用id属性来标识锚点，可以使用name属性，如下所示：

<span name="point">跳转锚点</span>

效果如下所示：

跳转锚点

第二步设置链接指向锚点：

可以设置展示的文本，以及跳转的锚点属性，在HTML页面中点击即可跳转，但是在Typora中需要CTRL+点击才能够跳转。

[点击跳转](#point)

点击跳转

3、添加键盘按键图标

我们在文章中表示键盘输入时，通常直接输入文本字符，该种表示方式可以更进一步，使用键盘按键图标表示。

如表示CTRL键，可以通过如下HTML代码：

<kbd>Ctrl</kbd>

效果如下所示：

Ctrl

4、添加表情包

在Typora中通过快捷键Win+.来选择想要添加的Emoji表情，如😘😘；

也可以通过表情符号代码添加，如:joy:，效果为：😂

5、隐藏文字

我们可以直接隐藏部分文本，如果使用鼠标选择这些文本就可以重现这些文本了，使用HTML标签将该文本的背景设置为当前的背景颜色：

<font color="white">nobody can f*** me!！！</font>

nobody can f*** me!！鼠标左滑查看隐藏文本！！！

6、为链接添加Title提示

当我们添加链接时，可以为该链接添加提示，也就是在鼠标悬浮在链接上时可以展示提示的文本，如下所示：

[百度一下，你就知道 (baidu.com)](https://www.baidu.com/)

百度一下，你就知道 (baidu.com)

7、自动生成目录

为文章添加目录，通过如下语法：

@[toc]

8、换行

使用HTML中的语法<br>来换行；

9、首行缩进

使用HTML中的空格符来缩进，直接在文本前添加即可，如下所示：

&emsp;&emsp;

三、Reference

(360条消息) Markdown 语法手册（完整整理版）_witnessai1的博客-CSDN博客_markdown语法

(361条消息) Markdown 基础操作 | 高级操作大全+Typora常用快捷键_Li Yikou的博客-CSDN博客_markdown 隐藏文字

(372条消息) Markdown语法文档，Markdown教程，Markdown语法大全，_伊人夕岸_的博客-CSDN博客_markdown语法文档

(377条消息) Markdown缩进控制_God-Excious的博客-CSDN博客_markdown缩进