Markdown基础与进阶语法

一、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中的空格符来缩进，直接在文本前添加即可，如下所示：

  

三、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缩进