文章目录

<a href="#_1">添加目录</a>

<a href="#1_2">1、前言</a>    <a href="#2_6">2、语法详解</a>    
 
  
  
   <a href="#21_7">2.1、目录的自动生成</a>       <a href="#22_31">2.2、手动书写目录</a>                <a href="#3_70">3、小结</a>      <a href="#2_74">2、添加代码行号</a>   

<a href="#21_75">2.1、添加代码块</a>    <a href="#22_78">2.2、给代码块加行数</a>      

添加目录

1、前言

目录是文章内容的整体索引，是文章结构的最直观表现形式。

Markdown 为生成目录提供了快捷方式，大大降低了文章目录的编排复杂度。

2、语法详解

2.1、目录的自动生成

在 Markdown 中，自动生成目录非常简单，只需要在恰当的位置添加 [TOC] 符号，凡是以 # 定义的标题都会被编排到目录中。

实例 1：

使用 [TOC] 生成文档目录导航。

@[toc]
# 一级标题

一些内容。。。。

## 二级标题

一些内容。。。。

### 三级标题

一些内容。。。。

渲染效果如下：

2.2、手动书写目录

尽管自动生成目录非常方便，我们也难免有自定义目录的需求，如只显示一二级大标题等。

手动添加目录的方法就是将「列表」和「页内超链接」相结合。

实例 2：

用列表和链接做出目录效果。

- [一级标题](#一级标题)
  - [标题 1-1](#二级标题 1-1)
  - [标题 1-2](#二级标题 1-2)
- [二级标题](#二级标题)
  - [标题 2-1](#二级标题 2-1)
  - [标题 2-2](#二级标题 2-2)
- [一级标题](#一级标题)
  - [标题 1-1](#二级标题 1-1)
  - [标题 1-2](#二级标题 1-2)
- [二级标题](#二级标题)
  - [标题 2-1](#二级标题 2-1)
  - [标题 2-2](#二级标题 2-2)

# 一级标题
一些内容……
## 二级标题 1-1
一些内容……
## 二级标题 1-2
一些内容……
# 二级标题
一些内容……
## 二级标题 2-1
一些内容……
## 二级标题 2-2
一些内容……

其渲染效果如下：

3、小结

Markdown 支持自动使用 [toc] 标记生成目录； 当自动生成的目录无法满足需求时，我们仍可通过「页内超链接」的形式定义目录； 由于 Markdown 没有分页的概念，所以目录中无法自动页码。

2、添加代码行号

2.1、添加代码块

开始和结束加三个点点```就行啦 可以用不同语言风格，在点后面加"py/sql/cpp(就是c++)"等等

2.2、给代码块加行数

在开始的点点后面加{.line-numbers} 示例：

```python {.line-numbers}

原文地址：https://blog.csdn.net/m0_54634272/article/details/128136766?ops_request_misc=%257B%2522request%255Fid%2522%253A%2522168905674116800227431657%2522%252C%2522scm%2522%253A%252220140713.130102334.pc%255Fall.%2522%257D&request_id=168905674116800227431657&biz_id=0&utm_medium=distribute.pc_search_result.none-task-blog-2~all~first_rank_ecpm_v1~rank_v31_ecpm-9-128136766-null-null.142^v88^control_2,239^v2^insert_chatgpt&utm_term=markdown