Markdown学习笔记

秒速五厘米 2021-09-25 01:20 244阅读 0赞

Markdown是一种轻量级标记语言，排版语法很简洁，也非常常用，CSDN博客的默认编写方式就是Markdown，以下为本人学习Markdown的笔记，为Markdown正文形式，显示形式可以复制全文到任意编辑器中查看。

本笔记的学习自网络教程\[Markdown语法\](https://markdown.com.cn "我用的语法教程")，内容为Markdown基本语法，很简单，只要有点基础，过一遍就能学会，不做笔记，最多耗时半小时

笔记标题后的快捷键是\*\*MarkdownPad2\*\*应用程序中的快捷键

学习的个人经验：每一个段落都和上下空开一行，而少用换行

似乎单纯的Markdown语法无法实现页面内跳转，必须内嵌HTML，这里没有用到

@\[TOC\]

\# 1、标题 \`Ctrl+1\`、\`Ctrl+2\`、...

要创建标题，请在单词或短语前面添加井号(\#)    
“\#”的数量代表了标题的级别

\#\# 注意

为了兼容考虑，请用一个空格在 \# 和标题之间进行分隔。

\# 2、段落

要创建段落，请使用空白行将一行或多行文本进行分隔

\#\# 注意

不要用空格（spaces）或制表符（tabs）缩进段落

\# 3、换行

在一行的末尾添加两个或多个空格，然后按回车键,即可创建一个换行

\#\# 注意

为了兼容性，请在行尾添加“结尾空格”或HTML的< br >标签来实现换行。

\# 4、强调

\#\# 粗体 \`Ctrl+B\`

要\*\*加粗\*\*文本，请在单词或短语的前后各添加两个星号（asterisks）或下划线（underscores）。如需加粗一个单词或短语的中间部分用以表示强调的话，请在要加粗部分的两侧各添加两个星号（asterisks）。

\#\# 斜体 \`Ctrl+I\`

要用\*斜体\*显示文本，请在单词或短语前后添加一个星号（asterisk）或下划线（underscore）。要斜体突出单词的中间部分，请在字母前后各添加一个星号，中间不要带空格。

\#\# 粗体和斜体

要同时用\*\*\*粗体和斜体\*\*\*突出显示文本，请在单词或短语的前后各添加三个星号或下划线。要加粗并用斜体显示单词或短语的中间部分，请在要突出显示的部分前后各添加三个星号，中间不要带空格。

\#\# 注意

为了实现兼容性，请使用星号将单词或短语的中间部分加粗并以斜体显示，以示重要。

\# 5、引用 \`Ctrl+Q\`  
要创建块引用，请在段落前添加一个 > 符号。  
> 试试看引用的效果

\#\# 多个段落的块引用  
块引用可以包含多个段落。为段落之间的空白行添加一个 > 符号。  
> 引用的第一行  
>  
> 引用的第二行

\#\# 嵌套块引用  
块引用可以嵌套。在要嵌套的段落前再添加一个 > 符号。  
> 引用的第一行  
>> 嵌套引用的第二行  
>>> 嵌套引用第三行

\#\# 带其他元素的块引用  
块引用可以包含其他 Markdown 格式的元素。并非所有元素都可以使用，你需要进行实验以查看哪些元素有效。  
> \#\#\#\# 标题元素可以用  
> - 这是什么效果    
>  
> \*斜体\*和\*\*粗体\*\*可以用

\# 6、列表

\#\# 有序列表 \`Ctrl+Shift+O\`

要创建有序列表，请在每个列表项前添加数字并紧跟一个英文句点。数字不必按数学顺序排列，但是列表应当以数字 1 起始。

1. 首先    
2. 其次    
3. 再者，空开后果然即便数字随机也可以  
    1. 这个感觉没有用啊  
    2. 还是需要在段之间空开一行才有  
4. 最后

\#\# 无序列表 \`Ctrl+U\`

要创建无序列表，请在每个列表项前面添加破折号 (-)、星号 (\*) 或加号 (+) 。缩进一个或多个列表项可创建嵌套列表。

\+ 这个需要和前文空开一行  
\+ 对的，用+感觉最好

\#\# 在列表中嵌套其他元素

要在保留列表连续性的同时在列表中添加另一种元素，请将该元素缩进四个空格或一个制表符，如下例所示：

\#\#\# 段落

\+ 这是第一行  
\+ 在第二行后插入时，文本需要空一行

第二行后插入一个段落

\+ 这是第三行

\#\#\# 引用块

\+ 这是第一行  
\+ 这是第二行，直接空开一行

> 引用应该莫得问题

\+ 经常空行应该是Markdown的应用核心了哈哈哈

\#\#\# 代码块

代码块通常采用四个空格或一个制表符缩进。当它们被放在列表中时，请将它们缩进八个空格或两个制表符。

1.  Open the file.  
2.  Find the following code block on line 21:

3.  Update the title to match the name of your website.

\#\#\# 图片

1.  Open the file containing the Linux mascot.  
2.  Marvel at its beauty.

!\[Tux, the Linux mascot\]\[2\]

3.  Close the file.

\#\#\# 列表 嵌套列表了

1. 尝试不空行  
2. 第二行  
    1. 嵌套列表直接就可以  
        + 可能没问题  
        + 三层了  
    2. 也回得去  
3. 还行，列表中只有插入其他元素才需要与列表上一行空开

\# 7、代码 \`Ctrl+k\`

要将单词或短语表示为代码，请将其包裹在反引号 (\`) 中。

插入如下代码块，\`import panda\`，反引号在Esc下面，可让我好找

\#\# 转义反引号

如果你要表示为代码的单词或短语中包含一个或多个反引号，则可以通过将单词或短语包裹在双反引号(\`\`)中。

\`\`代码中有带\`反引号\`的词，代码用双反引号包裹\`\`

\#\# 代码块

要创建代码块，请将代码块的每一行缩进至少四个空格或一个制表符。

\#include<stdio.h>  
    int main()  
    \{  
        printf("hello world!\\n");  
        return 0;  
    \}

嗐，还行

\#\# 围栏式代码块

Markdown基本语法允许您通过将行缩进四个空格或一个制表符来创建代码块。如果发现不方便，请尝试使用受保护的代码块。根据Markdown处理器或编辑器的不同，您将在代码块之前和之后的行上使用三个反引号（\`\`\`）或三个波浪号（~~~）。

感觉不太行啊，不如直接贴代码，然后\`Ctrl+K\`

\`\`\`

\#include<stdio.h>  
int main()  
\{  
    printf("hello world!\\n");  
    return 0;  
\}

\`\`\`

怎么感觉上面这个不太行，但不知道下面这个为什么可以，各种不同编辑器的显示效果有差异吧，看来MarkdownPad2算是功能比较简单的哈哈

\`\`\`  
\{  
  "firstName": "John",  
  "lastName": "Smith",  
  "age": 25  
\}  
\`\`\`

\# 8、分割线 \`Ctrl+R\` \#

要创建分隔线，请在单独一行上使用三个或多个星号 (\*\*\*)、破折号 (---) 或下划线 (\_\_\_) ，并且不能包含其他内容。

\----------

为了兼容性，请在分隔线的前后均添加空白行。

\# 9、链接 \#

链接文本放在中括号内，链接地址放在后面的括号中，链接title可选。

超链接Markdown语法代码：\`\[超链接显示名\](超链接地址 "超链接title")\`

这是一个链接 \[Markdown语法\](https://markdown.com.cn)。

\#\# 给链接增加title \#\#

链接title是当鼠标悬停在链接上时会出现的文字，这个title是可选的，它放在圆括号中链接地址后面，跟链接地址之间以空格分隔。

这是一个链接 \[Markdown语法\](https://markdown.com.cn "最好的markdown教程")。

\#\# 网址和Email地址 \#\#

使用尖括号可以很方便地把URL或者email地址变成可点击的链接。

<https://markdown.com.cn>

> 以后我应该做一个个人主页出来，嗐，想想就麻烦

这是一个邮箱<123456789@abc.com> 狗头

\#\# 带格式化的链接 \#\#

强调链接, 在链接语法前后增加星号。要将链接表示为代码，请在方括号中添加反引号。

加粗 \*\*\[Markdown语法\](https://markdown.com.cn)\*\*

斜体 \*\[Markdown语法\](https://markdown.com.cn)\*

代码 \[\`Markdown语法\`\](https://markdown.com.cn)

\#\# 引用类型链接 \#\#

引用样式链接是一种特殊的链接，它使URL在Markdown中更易于显示和阅读。参考样式链接分为两部分：与\*\*文本保持内联的部分\*\*以及\*\*存储在文件中其他位置的部分\*\*，以使文本易于阅读。

\#\#\# 链接的第一部分 \#\#\#

引用类型的链接的第一部分使用两组括号进行格式设置。第一组方括号包围应显示为链接的文本。第二组括号显示了一个标签，该标签用于指向您存储在文档其他位置的链接。

第一部分示例，这个示例链接是维基百科，应该点不开

\[hobbit-hole\]\[1\]

\#\#\# 链接的第二部分 \#\#\#

引用类型链接的第二部分使用以下属性设置格式：

1. 放在括号中的标签，其后紧跟一个冒号和至少一个空格（\[label\]:）。  
2. 链接的URL，可以选择将其括在尖括号中。  
3. 链接的可选标题，可以将其括在双引号，单引号或括号中。

第二部分示例 这部分好像在展示文本中不显示

可以将链接的第二部分放在Markdown文档中的任何位置。有些人将它们放在出现的段落之后，有些人则将它们放在文档的末尾（例如尾注或脚注）

\#\# 注意 \#\#

不同的 Markdown 应用程序处理URL中间的空格方式不一样。为了兼容性，请尽量使用%20代替空格。

这是一个可以随意引用的\[example\](https://www.example.com/my%20great%20page)

\# 10、图片 \#

要添加图像，请使用感叹号 (!), 然后在方括号增加替代文本，图片链接放在圆括号里，括号里的链接后可以增加一个可选的图片标题文本。

插入图片Markdown语法代码：\`!\[图片alt\](图片链接 "图片title")\`。

!\[这是图片\]\[3\]

\#\# 链接图片 \#\#

给图片增加链接，请将图像的Markdown括在方括号中，然后将链接添加在圆括号中。

\[!\[沙漠中的岩石图片\]\[4\]\]\[5\]

\[1\]: https://en.wikipedia.org/wiki/Hobbit\#Lifestyle (hobbit lifestyles)

\[2\]: https://th.bing.com/th/id/R858145d05460692ec7215d3cc8cb1867?rik=D%2fTjEcOIUmhF3A&riu=http%3a%2f%2fwww.leewiart.com%2fuserfiles%2f27314%2f65bf4cc7b5b64ea29e30516680b3dc41.jpg&ehk=Ta3UbaHbQWpSY8WH7p79J%2fwuJQOYbqOi7BSo9Jmezwk%3d&risl=&pid=ImgRaw (索隆，图源网络，侵删)

\[3\]: https://tse1-mm.cn.bing.net/th/id/OIP.khXmgansJE5ZbmtwuO9\_JAHaE6?o=6&pid=Api&rs=1 (Magci Garends，图源网络，侵删)

\[4\]: https://tse4-mm.cn.bing.net/th/id/OIP.ad1186JW6q8I909M\_lsZJAHaEo?o=6&pid=Api&rs=1 (沙漠中的岩石图片，图源网络，侵删，链接为搜索图像URL)

\[5\]: https://s2.best-wallpaper.net/wallpaper/2560x1600/1208/Rock-hill-in-the-desert\_2560x1600.jpg