Markdown扩展语法(中级)
表
要添加表格,请使用三个或更多连字符 ( —) 来创建每一列的标题,并使用竖线 ( |) 分隔每一列。为了兼容性,您还应该在行的任一端添加一个管道。
| Syntax | Description |
| ----------- | ----------- |
| Header | Title |
| Paragraph | Text |
渲染的输出如下所示:
Syntax | Description |
---|---|
Header | Title |
Paragraph | Text |
单元格宽度可以变化,如下所示。渲染的输出看起来是一样的。
| Syntax | Description |
| --- | ----------- |
| Header | Title |
| Paragraph | Text |
contom
表格内的对齐方式用
您可以通过在标题行内连字符的
左侧、右侧或两侧添加冒号 (:) 来将列中的文本向左、向右或居中对齐
。
| 左对齐 | 居中对齐 | 右对齐 |
| :--- | :----: | ---: |
| Header | Title | Here's this |
| Paragraph | Text | And more |
渲染的输出如下所示:
左对齐 | 居中对齐 | 右对齐 |
---|---|---|
Header | Title | Here’s this |
Paragraph | Text | And more |
格式化表格中的文本
您可以格式化表格中的文本。例如,您可以添加
链接
、代码
(仅在反引号 () 中的单词或短语,而不是**代码块**)和
强调`。您不能使用标题、块引用、列表、水平线、图像或大多数 HTML 标记。
围栏代码块
基本的 Markdown 语法允许您通过将行缩进四个空格或一个制表符来创建代码块。如果您觉得不方便,请尝试使用围栏代码块。根据您的 Markdown 处理器或编辑器,您将在代码块前后的行上使用三个反引号 ( ```) 或三个波浪号 ( )。~~~最好的部分?您不必缩进任何行!
{
"firstName": "John",
"lastName": "Smith",
"age": 25
}
渲染的输出如下所示:
{
“firstName”: “John”,
“lastName”: “Smith”,
“age”: 25
}
语法高亮
许多 Markdown 处理器支持对受保护的代码块进行语法高亮显示。此功能允许您为编写代码的任何语言添加颜色突出显示。要添加语法突出显示,请在受保护的代码块之前的反引号旁边指定一种语言。
**```json**
{
"firstName": "John",
"lastName": "Smith",
"age": 25
}
**```**
渲染的输出如下所示:
{
"firstName": "John",
"lastName": "Smith",
"age": 25
}
脚注
脚注允许您添加注释和参考,而不会弄乱文档的正文。当您创建脚注时,带有链接的上标编号会出现在您添加脚注引用的位置。读者可以点击链接跳转到页面底部脚注的内容。
1要创建脚注引用,请在方括号 ( )内添加插入符号和标识符。标识符可以是数字或单词,但不能包含空格或制表符。标识符仅将脚注引用与脚注本身相关联——在输出中,脚注按顺序编号。
在带有冒号和文本 ( 1: My footnote.) 的括号内使用另一个插入符号和数字添加脚注。您不必在文档末尾添加脚注。除了列表、块引号和表格等其他元素之外,您可以将它们放在任何地方。
这是一个简单的脚注[^1],这是一个更长的脚注。[^bignote]
[^1]:这是第一个脚注。 ↩
[^bignote]: 这是一个有多个段落和代码的。缩进段落以将它们包含在脚注中。{ my code }添加尽可能多的段落。 ↩
渲染的输出如下所示:
标题 ID
许多 Markdown 处理器支持标题的自定义ID——一些 Markdown 处理器会自动添加它们。添加自定义 ID 允许您直接链接到标题并使用 CSS 修改它们。要添加自定义标题 ID,请将自定义 ID 括在与标题相同的行上的花括号中。
Markdown 官网自定义标题设置锚点是错误的(Typor 亲测)
正确的写法两种 name只能为英文,中文不能跳转:表
我是自定义标题
### 我是自定义标题 {#custom-id}
渲染的输出如下所示:
我是自定义标题
链接到标题 ID
您可以通过创建带有
数字符号
( ) 后跟自定义标题 ID的标准链接
来链接到文件中具有自定义 ID 的标题
。#这些通常称为锚链接
。
Markdown写法 | HTML | 渲染输出 |
---|---|---|
[标题 ID](#divtop) | <a href="#divtop">标题 ID</a> | 跳转到标题 ID |
## contom | <h2 id='contom'>contom</h2> | 跳转去contom |
## custom-id | <h2 id='custom-id'>custom-id</h2> | 跳转去custom-id |
定义列表
一些 Markdown 处理器允许您创建术语的定义列表及其相应的定义。要创建定义列表,请在第一行键入术语。在下一行,键入一个冒号,后跟一个空格和定义。
第一学期
: 这是第一项的定义。
第二期
: 这是第二个术语的一个定义。
: 这是第二个术语的另一个定义。
<dl>
<dt>第一学期</dt>
<dd>这是第一项的定义。</dd>
<dt>第二期</dt>
<dd>这是第二个术语的一个定义。</dd>
<dd>这是第二个术语的另一个定义。</dd>
<dl>
渲染的输出如下所示:
-
第一学期
- 这是第一项的定义。 第二期
- 这是第二个术语的一个定义。
- 这是第二个术语的另一个定义。
删除线
您可以通过在单词中心放置一条水平线来删除单词。结果看起来**
像这样.** 此功能允许您指出某些单词是错误的,不应包含在文档中。~~要删除单词,请在单词前后使用两个波浪号 (~~
)。
\~~世界是平的\~~。我们现在知道世界是圆的。
渲染的输出如下所示:
世界是平的。我们现在知道世界是圆的。
任务列表
任务列表(也称为清单和待办事项列表)允许您创建带有复选框的项目列表。在支持任务列表的 Markdown 应用程序中,复选框会显示在内容旁边。
要创建任务列表,请在任务列表项前添加破折号 ( -) 和带空格 ( ) 的括号。[ ]要选择复选框,x请在括号 ( [x]) 之间添加一个
。
- [x] JavaScript
- [ ] Java
- [ ] GoLang
- [x] C++
渲染的输出如下所示:
- JavaScript
- Java
- GoLang
- C++
表情符号😂
将表情符号添加到 Markdown 文件有两种方法:
将表情符号复制并粘贴到 Markdown 格式的文本中
,或键入emoji 短代码
。
复制和粘贴表情符号
在大多数情况下,您可以简单地从Emojipedia等来源复制表情符号并将其粘贴到您的文档中。许多 Markdown 应用程序会自动以 Markdown 格式的文本显示表情符号。您从 Markdown 应用程序导出的 HTML 和 PDF 文件应显示表情符号。
提示:如果您使用的是静态网站生成器,请确保将HTML 页面编码为 UTF-8。
使用表情符号简码
一些 Markdown 应用程序允许您通过输入
表情符号短代码
来插入表情符号。这些以冒号开头和结尾,并包含表情符号的名称。
去露营了!:tent: 快回来。
太搞笑了!:joy:
渲染的输出如下所示:
去露营了!⛺️ 快回来。
太搞笑了!😂
强调
这并不常见,但一些 Markdown 处理器允许您突出显示文本。结果看起来像这样. 要突出显示单词,请在
单词前后使用两个等号(==)
。
我需要强调这些==很重要的话.==
渲染的输出如下所示:
我需要强调这些很重要的话.
下标
这并不常见,但一些 Markdown 处理器允许您使用下标将一个或多个字符定位在略低于正常类型行的位置。要创建下标,请在字符前后使用一个波浪号
(~)
。
H~2~O
渲染的输出如下所示:
H2O
HTML语法
H<sub>2</sub>O
上标
这并不常见,但一些 Markdown 处理器允许您使用上标将一个或多个字符定位在略高于正常类型行的位置。要创建上标,请在字符前后使用一个插入符号
(^)
。
X^2^
渲染的输出如下所示:
X2
HTML语法
X<sup>2</sup>
自动 URL 链接
许多 Markdown 处理器会
自动将 URL 转换为链接。
这意味着如果您键入 http://www.example.com,即使您没有使用括号,您的 Markdown 处理器也会自动将其转换为链接。
http://www.example.com
渲染的输出如下所示:
http://www.example.com
禁用自动 URL 链接
如果您不希望自动链接 URL,可以通过将 URL 表示为带有
反引号
的代码来删除链接。
`http://www.example.com`
渲染的输出如下所示:
http://www.example.com