Markdown扩展语法

本文详细介绍了Markdown的扩展语法,包括表格、自定义标题ID、脚注、任务列表、删除线、表情符号、高亮和下标等。此外,还涵盖了如何创建链接、代码块以及使用不同的对齐方式。通过对Markdown的深入理解,可以提升文档的可读性和专业性。
摘要由CSDN通过智能技术生成

Markdown扩展语法(中级)

要添加表格,请使用三个或更多连字符 ( —) 来创建每一列的标题,并使用竖线 ( |) 分隔每一列。为了兼容性,您还应该在行的任一端添加一个管道。

| Syntax      | Description |
| ----------- | ----------- |
| Header      | Title       |
| Paragraph   | Text        |

渲染的输出如下所示:

SyntaxDescription
HeaderTitle
ParagraphText

单元格宽度可以变化,如下所示。渲染的输出看起来是一样的。

| Syntax | Description |
| --- | ----------- |
| Header | Title |
| Paragraph | Text |

contom

表格内的对齐方式用

您可以通过在标题行内连字符的左侧、右侧或两侧添加冒号 (:) 来将列中的文本向左、向右或居中对齐

| 左对齐     | 居中对齐 | 右对齐     |
| :---        |    :----:   |          ---: |
| Header      | Title       | Here's this   |
| Paragraph   | Text        | And more      |

渲染的输出如下所示:

左对齐居中对齐右对齐
HeaderTitleHere’s this
ParagraphTextAnd 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 }添加尽可能多的段落。 ↩

渲染的输出如下所示:

这是一个简单的脚注1,这是一个更长的脚注。2

标题 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


  1. 这是第一个脚注。 ↩︎ ↩︎ ↩︎

  2. 这是一个有多个段落和代码的。缩进段落以将它们包含在脚注中。{ my code }添加尽可能多的段落。 ↩︎

  • 0
    点赞
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值