文章目录
前言
参考Markdown官方教程。
Markdown是什么:Markdown 是一种轻量级的标记语言,可用于在纯文本文档中添加格式化元素。
Markdown有什么用:Markdown 是做笔记、为网站创建内容以及生成可打印文档的快速、简便的方法。
如下是Markdown教程:
一、标题
说明:#
可选:还可以在文本下方添加任意数量的 == 号来标识一级标题,或者 – 号来标识二级标题。
示例:
Heading level 1
=========
Heading level 2
---------
二、段落
说明:要创建段落,请使用空白行将一行或多行文本进行分隔。不要用空格(spaces)或制表符( tabs)缩进段落。
示例:
I really like using Markdown.
I think I’ll use it to format all of my documents from now on.
三、换行
说明:最佳实践是使用<br>标记。还有一种方式是在一行的末尾添加两个或多个空格,然后按回车键,即可创建一个换行(<br>)。
示例:
first line
second line
third line
四、强调语法
说明:
- 使用** 粗体 加粗文本
- 使用__ 粗体 加粗文本(部分可用)
- 使用* 斜体 突出显示文本
- 使用_ 斜体 突出显示文本
- 使用*** 同时 应用粗体和斜体
- 使用___ 同时 应用粗体和斜体
五、引用语法
说明:要创建块引用,请在段落前添加一个 > 符号。
示例:
这是引用
这是引用第三行
外层引用嵌套块引用
带有其它元素的块引用
- 无序列表
粗体和斜体
六、列表语法
说明:
- 可以将多个条目组织成有序或无序列表。
- 要创建有序列表,请在每个列表项前添加数字并紧跟一个英文句点。 数字不- 必按数学顺序排列,但是列表应当以数字 1 起始。
- 要创建无序列表,请在每个列表项前面添加破折号 (-)、星号 (*) 或加号 (+) 。缩进一个或多个列表项可创建嵌套列表。
示例:
有序列表
- first item
- second item
- third item
- third Indented item
- third Indented item
- fourth item
无序列表
- First item
- Second item
- Third item
- Indented item
- Indented item
- Fourth item
在列表中嵌套其他元素
要在保留列表连续性的同时在列表中添加另一种元素,请将该元素缩进四个空格或一个制表符.
从实际操作来看,要达到该效果,需要在列表和其他元素之间插入一行。
-
first line
abcdefg
-
second line
<html> <head> <title>Test</title> </head> </html>
-
third line
七、代码语法
说明:
- 要将单词或短语表示为代码,请将其包裹在反引号 (`) 中。
- 如果你要表示为代码的单词或短语中包含一个或多个反引号,则可以通过将单词或短语包裹在双反引号(``)中。
- 要创建代码块,请将代码块的每一行缩进至少四个空格或一个制表符。
- 要使用受保护的代码块,在代码块之前和之后的行上使用三个反引号(```)或三个波浪号(~~~)
示例:
-
反引号:input
<html> <head> </head> </html>
. -
转义反引号: input
Use `code` in your Markdown file.
-
代码块:
<html> <head> </head> </html>
-
围栏代码块:
{ "firstName": "John", "lastName": "Smith", "age": 25 }
八、分隔线语法
说明:
要创建分隔线,请在单独一行上使用三个或多个星号 (***)、破折号 (—) 或下划线 (___) ,并且不能包含其他内容。
示例:
九、链接语法
说明:
- [超链接显示名] (超链接地址 “超链接title”)
- URL或email:使用尖括号可以很方便地把URL或者email地址变成可点击的链接。
- 带格式化的链接:粗体强调、斜体、代码。
- 引用类型链接:
引用样式链接是一种特殊的链接,它使URL在Markdown中更易于显示和阅读。参考样式链接分为两部分:与文本保持内联的部分以及存储在文件中其他位置的部分,以使文本易于阅读。
示例:
I love supporting the EFF.
I love supporting the EFF.
See the section on code
.
[hobbit-hole] archorA
十、图片语法
说明:
- ![图片alt](图片链接 “图片title”)
- [![图片alt](图片链接 “图片title”)](超链接地址)
示例:
[![linux官网](https://www.linux.org/images/logo.png “org.linux picture”)](https://www.linux.org/)
十一、转义字符语法
说明:
- 基本语法:要显示原本用于格式化 Markdown 文档的字符,请在字符前面添加反斜杠字符\。
- 特殊字符自动转义:在 HTML 文件中,有两个字符需要特殊处理: < 和 & 。 < 符号用于起始标签,& 符号则用于标记 HTML 实体。Markdown 允许你直接使用这些符号,它帮你自动转义字符。
十二、内嵌HTML标签
说明:
- 对于 Markdown 涵盖范围之外的标签,都可以直接在文件里面用 HTML 本身。
- HTML 的行级內联标签不受限制,可以在 Markdown 的段落、列表或是标题里任意使用。
- 区块元素,必须在前后加上空行,以便于内容区分。而且这些元素的开始与结尾标签,不可以用 tab 或是空白来缩进。
- 在 HTML 块级标签内不能使用 Markdown 语法。
- 出于安全原因,并非所有 Markdown 应用程序都支持在 Markdown 文档中添加 HTML。
十三、扩展语法 {#extended-syntax}
表格
说明:要添加表,请使用三个或多个连字符(—)创建每列的标题,并使用管道(|)分隔每列。您可以选择在表的任一端添加管道。
示例:
Syntax | Description |
---|---|
Header | Title |
Paragraph | Text |
围栏代码块
说明:
- Markdown基本语法允许您通过将行缩进四个空格或一个制表符来创建代码块。如果发现不方便,请尝试使用受保护的代码块。根据Markdown处理器或编辑器的不同,您将在代码块之前和之后的行上使用三个反引号(```)或三个波浪号(~~~)。
- 许多Markdown处理器都支持受围栏代码块的语法突出显示。
脚注
说明:
脚注使您可以添加注释和参考,而不会使文档正文混乱。当您创建脚注时,带有脚注的上标数字会出现在您添加脚注参考的位置。读者可以单击链接以跳至页面底部的脚注内容。
示例:
Here’s a simple footnote,(1:my footnote) and here’s a longer one.2
标题编号
说明:许多Markdown处理器支持标题的自定义ID - 一些Markdown处理器会自动添加它们。添加自定义ID允许您直接链接到标题并使用CSS对其进行修改。要添加自定义标题ID,请在与标题相同的行上用大括号括起该自定义ID。
示例:
this is a link: link head.
定义列表
说明:一些Markdown处理器允许您创建术语及其对应定义的定义列表。要创建定义列表,请在第一行上键入术语。在下一行,键入一个冒号,后跟一个空格和定义。
删除线
说明:要从文档中删除。若要删除单词,请在单词前后使用两个波浪号~~。
任务列表语法
说明:任务列表使您可以创建带有复选框的项目列表。在支持任务列表的Markdown应用程序中,复选框将显示在内容旁边。要创建任务列表,请在任务列表项之前添加破折号-和方括号[ ],并在[ ]前面加上空格。要选择一个复选框,请在方括号[x]之间添加 x 。
使用 Emoji 标签
说明:有两种方法可以将表情符号添加到Markdown文件中:将表情符号复制并粘贴到Markdown格式的文本中,或者键入emoji shortcodes。
自动网址链接
说明:许多Markdown处理器会自动将URL转换为链接。
N、其他
输入空格的几种方式
-
html实体
# #
 # #
 # #
 # #
‌##
‍## -
内嵌行公式
说明:$~~~~$
示例:
| ~ 1 ~~~ 2 ~~~ 3 ~~~ 4 ~ |
| ~ 5 ~~~ 6 ~~~ 7 ~~~ 8 ~ |
| ~ 9 ~~~ 10 ~ 11 ~ 12 ~ |
| ~ 13 ~ 14 ~ 15 ~ 16 ~ | -
应用样式
<style> p { text-indent: 2em } </style>