Markdown语法学习笔记

2022-04-09 16:35:19 阅读：233 来源： 互联网

Markdown基本语法

Markdown是一种轻量级的标记语言，排版语法简洁，让人们更多地关注内容本身而非排版。它使用易读写的纯文本格式编写文档，可与HTML混编，可导出HTML、PDF以及本身的.md格式的文件。因简洁、高效、易读、易写，Markdown被大量使用，如Github、Wikipedia、简书等。

Markdown基本语法地址：https://markdown.com.cn/basic-syntax/code.html
Markdown扩展语法地址：https://markdown.com.cn/extended-syntax/

Markdown基本语法地址

Markdown标题语法

Markdown语法：井号+空格+标题文字（仅在一个空格在井号和标题文字间间隔，后面的标题文字间不要有空格，否则可能会报错）

注意：1. 井号+空格须放在句首，但井号不区分半角/全角。

2. 一个井号表示一级标题，两个井号表示二级标题，依次类推，总共有六级标题。

HTML语法：xml格式 <h1>文字</h1>

1. <h1>文字</h1>须位于句首，且<>须为半角

h1代表一级标题，h2代表二级标题，...h6代表六级标题

Markdown可选语法：也可以在标题文字下方添加任意数量（不超过6个）=标识一级标题；在标题文字下方添加任意数量的--标识二级标题。

Markdown段落语法

Markdown段落语法：要创建段落请使用空白行将一行或者多行文本分隔。

HTML段落语法：<p>文字</p>>

注意：不要用空格或制表符（tab）缩进段落。

Markdown换行语法

Markdown换行语法：在一行的末尾添加两个或者多个空格然后按回车键，即可完成换行。

HTML换行语法：<p> </p>

Markdown强调语法

粗体

Markdown加粗语法：

加粗文本：请在单词或者短语的前后端各添加两个星号（**）或者下划线（__）
加粗一个单词或者单词的中间部分（汉语用不到加粗一个单词的中间部分）：请在要加粗的部分两侧各添加两个星号（**）。

注意：*不区分全角/半角。

HTML加粗语法：文字

注意：加粗中间的文字不推荐使用两个下划线,有可能不兼容。尽管汉语是可以这么使用。

斜体

Markdown斜体语法：

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

HTML斜体语法：斜体

注意：要用斜体强调单词中间的部分，请用星号（*）。

既加粗又倾斜

Markdown既要加粗又要倾斜的语法：

文本就要加粗又倾斜：请在单词或者短语前后各添加三个星号（***）或下划线（___）。
单词或单词中间部分既要加粗又要倾斜：请在要突出显示的部分前后各添加三个星号，中间不要带空格。

HTML既要加粗又要倾斜的语法：<strong><em>进行组合，须成对出现且位置须一致，否则根据第一个<>中的单词匹配。

注意：凡是需要强调文本中间部分，尽可能不要使用下划线，养成习惯，避免在其他地方不兼容。

Markdown引用语法

Markdown引用语法：要创建引用，请在段落前添加一个大于号（>）。

单个段落的引用

多个段落块的引用

块引用可以包含多个段落。每个段落包括段落间的空行前分别添加一个大于号（>）。

嵌套块引用

块引用可以嵌套。在被嵌套的段落前再添加一个大于号（>）。可以主机

进行多级嵌套，只需每次在被嵌套的段落前添加一个大于号（>）即可。

带有其他元素的块引用

块引用可以包含其他Markdown格式的元素。但并非所有的元素都可以使用，需要进行验证。

Markdown列表语法

可以将多个条目组织成有序或无序列表。

有序列表

创建有序列表：需在每个列表前添加一个数字并紧跟一个半角的句点。数字不必按数学顺序排列，但列表应当以数字1起始。

Markdown有序列表语法：1.

HTML有序列表语法：<ol>+<li>嵌套

注意：Markdown语法：数字后必须跟半角句号，不能是其他。

无序列表

创建无序列表：请在每个列表前添加波折号（-）、星号（*）或加号（+）。缩进一个或者多个列表可创建嵌套列表。

Markdown无序列表语法：加波折号（-）、星号（*）或加号（+）单一使用。

HTML无序列表语法：<ul>+<li>嵌套

注意：Markdown不允许加波折号（-）、星号（*）和加号（+）混合使用。

在列表中嵌套其他元素

要在保留列表连续性的同时在列表中添加另一种元素，请将该元素缩进一个制表符（tab）或者四个空格。

Markdown代码语法

要将单词或短语作为代码

Markdown语法：请将其包裹在反单引号（半角、tab键上方）中。
HTML语法：代码

转义反引号

Markdown转义语法：依然使用反单引号。
HTML转义语法：也是使用反单引号包裹关键字code

代码块

创建缩进的代码块：请将代码块每一行缩进一个制表符或者四个空格。

创建不缩进的代码块：参考围栏式代码块

Markdown分割线语法

Markdown创建分割线语法：请在单独一行上使用三个或多个星号（***）、波折号（---）或下划线（___）

注意：为了兼容性，请在分割线前后均添加空白行

Markdown链接语法

Markdown创建链接语法：链接文本放在方括号内，链接地址放在后面的圆括号内，链接的title可选
Markdown创建超链接语法：[超链接显示名](超链接地址"超链接title")
Markdown创建超链接语法：超链接显示名

注意：方括号和圆括号必须紧挨着，中间不能有空格

带Title的链接

链接title是当鼠标悬停在链接上是会出现的文字，这个title是可选的，它放在圆括号中链接地址后面，跟链接地址之间以空格分隔（为了兼容性，请使用%20代替空格）。

链接title的展示

网址和email地址

网址和email地址的HTML语法：使用尖括号可以很方便的将URL地址或者email地址变成可点击的链接

带格式化的链接

强调链接：在链接语法前后增加星号（*）
要将链接表示为代码:请在方括号中添加反引号

引用类型链接

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

链接的第一部分格式:使用两组方括号进行格式设置。

第一组方括号包围应显示为链接的文本

第二组方括号显示了一个标签： 该标签用于指向您存储在文档中的其他位置的链接

注意：

尽管不是必须的，可以在第一组合第二组方括号之间包含一个空格。

第二组方括号中的标签不区分大小写，可以包含字母、数字、空格或者标点符号。

链接的第二部分格式：使用一下属性设置格式

放在括号中的标签，其后紧跟一个冒号和至少一个空格（例如[label]: ）。

链接的URL，可以选择将其括在尖括号中。

链接的可选标题，可以将其括在双引号、单引号或者括号中

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

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

Markdown图片语法

添加图片

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

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

链接图片

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

Markdown转义字符语法

要显示原本格式化Markdown文档的字符： 请在字符签名添加反斜杠（\）。

需转义的字符

特殊字符自动转义

在HTML文件中，<和&需要特殊处理。

<：用于起始标签。

&：用于标记HTML实体。

使用这些符号，必须要使用实体的形式。如<和&

注意：&很容易让写网页文件的人感到困扰，如果要打『AT&T』,必须写成『AT&T』;如果你要得到链接，还要转换网址内的&符号。

&被转换后的链接才能放到href属性里。

Markdown允许你直接使用这些符号，他帮你自动转义字符。如果使用&符号作为HTML实体的一部分，那么他是不会被转换，而在其他情况下，他则会被转换成&。所有如果在文件中插入著作权符号，你可以写成©。

但是，Markdown不会讲AT&T这段文字进行修改，如果要写成AT&T。

类似的情况也发生在<符号上，因为Markdown支持行内HTML，如果你是用<作为HTML标签的分隔符，Markdown也不会对它进行任何转换。但是你写 4 < 5 Markdown将会转换为4 amp; 5。

需要特别注意的是，在 Markdown 的块级元素和内联元素中， < 和 & 两个符号都会被自动转换成 HTML 实体，这项特性让你可以很容易地用 Markdown 写 HTML。（在 HTML 语法中，你要手动把所有的 < 和 & 都转换为 HTML 实体。）

Markdown内嵌HTML语法

对于Markdown涵盖范围之外的标签，都可以直接在文件中用HTML本身。如需使用HTML，不需要额外标志这是HTML或是Markdown，只需HTML标签添加到Markdown文本即可。

注意：Markdown 语法在 HTML 区块标签中将不会被进行处理。例如，你无法在 HTML 区块内使用 Markdown 形式的*强调*。

行级内联标签

HTML中的行级内联标签如<span>、<cite>、<del>不收限制，可以在Markdown的段落、列表或是标题中任意使用。

如果比较喜欢HTML的<a>、或者<img>标签，可以直接使用这些标签，而不用Markdown提供的链接或者图片语法。当需要修改元素属性时（例如为文本指定颜色或者更改图像的亮度），使用HTML标签更方便些。

区块标签

区块元素—比如<div>、<table>、<pre>、<p>

等标签，必须在前后加上空行，以便内容区分。

而且这些元素的开始于结尾标签，不可以使用tab或者空格来缩进。

Makedown会自动识别这些区块元素，避免在区块标签前后加上没必要的<p>标签。

对于 HTML 的块级元素 <div>、<table>、<pre> 和 <p>，请在其前后使用空行（blank lines）与其它内容进行分隔。尽量不要使用制表符（tabs）或空格（spaces）对 HTML 标签做缩进，否则将影响格式。

在 HTML 块级标签内不能使用 Markdown 语法。例如 <p>italic and **bold**</p> 将不起作用。

Markdown的扩展语法

Markdown扩展语法入门

Markdown扩展语法可用性

Markdown表格

Markdown围栏代码块

Markdown脚注

Markdown标题序号

Markdown定义列表

Markdown删除线

Markdown使用列表语法

Markdown使用Emoji表情

自动网址链接

标签：空格,Markdown,标签,笔记,语法,HTML,链接
来源： https://www.cnblogs.com/roberts/p/16122426.html

本站声明： 1. iCode9 技术分享网（下文简称本站）提供的所有内容，仅供技术学习、探讨和分享；
2. 关于本站的所有留言、评论、转载及引用，纯属内容发起人的个人观点，与本站观点和立场无关；
3. 关于本站的所有言论和文字，纯属内容发起人的个人观点，与本站观点和立场无关；
4. 本站文章均是网友提供，不完全保证技术分享内容的完整性、准确性、时效性、风险性和版权归属；如您发现该文章侵犯了您的权益，可联系我们第一时间进行删除；
5. 本站为非盈利性的个人网站，所有内容不会用来进行牟利，也不会利用任何形式的广告来间接获益，纯粹是为了广大技术爱好者提供技术内容和技术思想的分享性交流网站。

ICode9