Заголовки Markdown

Заголовки Markdown имеют два формата.

1. Использование = и - для обозначения заголовков уровня 1 и уровня 2

Формат синтаксиса, обозначаемый с помощью = и -, выглядит следующим образом:

I am showing a level-1 heading
=================

I am showing a level-2 heading
-----------------

Эффект отображения показан на рисунке ниже:

Использование символа # для обозначения заголовков

Markdown использует#символ # для создания заголовков, который происходит из<h1>в<h6>концепции тегов HTML.

Используя#символ #, можно обозначать заголовки уровней 1-6. Заголовок уровня 1 соответствует одному#символу #, заголовок уровня 2 соответствует двум#символам #, и так далее.

# Level 1 Heading
## Level 2 Heading
### Level 3 Heading
#### Level 4 Heading
##### Level 5 Heading
###### Level 6 Heading

Эффект отображения показан на рисунке ниже:

Важные замечания:

Пробел между символом и текстом:#Между символом # и текстом заголовка должен быть пробел. Это стандартное требование синтаксиса Markdown.

# Correct syntax
#Incorrect syntax

Позиция в начале строки:#Символ # должен находиться в начале строки, без каких-либо других символов (пробелов или знаков табуляции) перед ним.

Единственный заголовок уровня 1: В документе обычно используется только один заголовок уровня 1 в качестве главного заголовка документа, что соответствует рекомендациям по хорошей структуре документа.

Структура вложенности заголовков

Иерархия заголовков должна следовать логическому порядку и не должна пропускать уровни. Хорошая структура заголовков подобна оглавлению книги:

Рекомендуемая иерархия:

# 主题:人工智能概述

## 第一部分:基础概念
### 什么是人工智能
### 发展历史
#### 早期发展(1950-1980)
#### 现代发展(1980至今)

## 第二部分:应用领域
### 自然语言处理
### 计算机视觉
### 机器学习
#### 监督学习
#### 无监督学习
#### 强化学习

Неправильные структуры, которых следует избегать:

# Main Heading
### Jumping directly to a level-3 heading (not recommended)
## Then a level-2 heading

Лучшие практики нумерации заголовков

Автоматическая нумерация против ручной нумерации:

Многие процессоры Markdown и редакторы поддерживают автоматическое создание номеров заголовков, поэтому обычно не нужно добавлять номера вручную в исходном коде:

# Introduction
## Background
## Objectives
# Methodology
## Data Collection
## Analysis Methods

Якоря заголовков:

Большинство процессоров Markdown автоматически создают якоря для заголовков, что позволяет легко переходить в пределах страницы:

[Jump to the Methodology section](#方法论)

Рекомендации по длине заголовков:

  • Делайте заголовки краткими и понятными, обычно не более 10 китайских иероглифов или 20 английских символов.
  • Используйте описательные слова и избегайте расплывчатых заголовков, таких как "Прочее" и "Разное".
  • Можно использовать двоеточие для разделения основной темы и подтемы.
Другие расширения