Markdown Hướng dẫn tiêu đề: H1 đến H6, Thực tiễn tốt nhất, và SEO

Các tiêu đề là xương sống của bất kỳ tài liệu Markdown nào. Chúng xác định cấu trúc, cho phép điều hướng, ảnh hưởng đến khả năng truy cập và ảnh hưởng SEO. Hướng dẫn này bao gồm tất cả mọi thứ về Markdown tiêu đề Thuật ngữ, quy tắc phân cấp, sự khác biệt của nền tảng và thực tiễn tốt nhất.

Thuật ngữ tiêu đề

Markdown tiêu đề sử dụng # biểu tượng (giống ATX). Số lượng # ký tự xác định mức tiêu đề:

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

Ngoài ra còn có phong cách Setext (chỉ H1 và H2):

Heading 1
=========

Heading 2
---------

Phong cách ATX (#) được rõ ràng hơn và hoạt động cho tất cả sáu cấp.

Ý nghĩa của mỗi cấp

Mức độ	HTML Tag	Mục đích
H1	`<h1>`	Tiêu đề trang hoặc tài liệu
H2	`<h2>`	Phần chính
H3	`<h3>`	Phân đoạn trong H2
H4	`<h4>`	Phân đoạn nhỏ trong H3
H5	`<h5>`	Thường không được sử dụng trong thực tiễn
H6	`<h6>`	Gần như không bao giờ cần thiết

Hầu hết các tài liệu chỉ sử dụng H1H3. H4H6 thường chỉ ra cấu trúc tài liệu quá sâu.

H1: Một trên mỗi trang

Một tiêu đề H1 nên xuất hiện chính xác một lần cho mỗi tài liệu Markdown. Nó đại diện cho tiêu đề của tài liệu hoặc chủ đề chính của trang.

Tốt.

# How to Convert Word to Markdown

Tránh:

# Section One
...
# Section Two  ← Don't use multiple H1s

Các công cụ tìm kiếm và các công cụ truy cập mong đợi một H1 duy nhất cho mỗi trang. Nhiều H1 làm nhầm lẫn cả hai.

Quy tắc phân cấp tiêu đề

Luôn tiến hành theo thứ tự. Đừng bỏ qua các cấp độ:

Đúng:

# Document Title
## Section
### Subsection
#### Detail

Không chính xác:

# Document Title
#### Jumped to H4  ← Skips H2 and H3

Bỏ qua các cấp tiêu đề vi phạm phác thảo tài liệu và không tuân thủ các hướng dẫn về khả năng truy cập của WCAG.

Chuyển đổi Word tiêu đề thành Markdown

Khi bạn chuyển đổi một tài liệu Word với WordToMD, Words xây dựng trong kiểu tiêu đề bản đồ trực tiếp:

Word Phong cách	Markdown Sản lượng
Nhóm 1	`# Heading`
Nhóm 2	`## Heading`
Nhóm 3	`### Heading`
Thông thường + đậm	`Bold text` (Không có tiêu đề)

Vấn đề phổ biến nhất: các nhà văn thủ công đậm và tăng kích thước phông chữ thay vì áp dụng phong cách tiêu đề. Điều này tạo văn bản trông giống như một tiêu đề trong Word nhưng chuyển đổi thành văn bản đậm đơn giản trong Markdown. Xem thêm Word đến Markdown Hướng dẫn định dạng để sửa chữa chuyện này.

ID tiêu đề và liên kết neo

Hầu hết các bộ xử lý Markdown tự động tạo ID từ văn bản tiêu đề:

## Getting Started

Máy phát điện: <h2 id="getting-started">Getting Started</h2>

Bạn có thể liên kết đến nó:

See the [Getting Started section](#getting-started).

Quy tắc cho ID tự động tạo:

Tất cả các ký tự chữ cái nhỏ
Thay thế khoảng trống bằng dấu ghim
Biểu tượng đặc biệt trừ dấu ghim

Ví dụ:

## API Reference → #api-reference
## What's New? → #whats-new
## Step 1: Install → #step-1-install

Bảng nội dung

Đối với các tài liệu dài, tạo TOC bằng cách sử dụng các liên kết neo tiêu đề:

## Table of Contents
- [Installation](#installation)
- [Configuration](#configuration)
  - [Basic Settings](#basic-settings)
  - [Advanced Options](#advanced-options)
- [Usage](#usage)
- [FAQ](#faq)

GitHub tự động tạo ra một TOC ở góc trên bên trái của bất kỳ tệp Markdown nào có tiêu đề.

SEO Các cân nhắc

Đối với Markdown được sử dụng trong các trang web tĩnh (Jekyll, Hugo, Astro) và được công bố trên web:

H1 = tiêu đề trang Bao gồm từ khóa chính của bạn. Mỗi trang một.
H2s = các phần chính Bao gồm các từ khóa thứ cấp một cách tự nhiên
H3s = các phần nhỏ Các chủ đề cụ thể hơn
Giữ tiêu đề mô tả Làm thế nào để cài đặt phụ thuộc beat cài đặt
Các tiêu đề được lập chỉ mục bởi các công cụ tìm kiếm làm cho chúng có thể quét

Xem thêm Word đến Static Site Generator để công bố các tài liệu Markdown trên web.

Phương tiện truy cập

Máy đọc màn hình sử dụng phân cấp tiêu đề để giúp người dùng điều hướng. Hướng dẫn:

Không bỏ qua các cấp hướng (H1 → H3 mà không có H2)
Đừng chỉ sử dụng tiêu đề để định dạng trực quan (thay vào đó hãy sử dụng bold hoặc CSS)
Làm cho văn bản tiêu đề có ý nghĩa tránh Phần 1, Phần A
Giữ tiêu đề ngắn gọn nhưng mô tả

Định dạng tiêu đề theo nền tảng

Nền tảng	H1-H6	Auto-ID	Auto-TOC
GitHub	✅	✅	✅ (thông qua nút)
Obsidian	✅	✅	Thông qua plugin
GitBook	✅	✅	✅ (bàn bên)
Notion	Chỉ H1-H3	❌	❌
VS Code Preview	✅	✅	❌
Confluence	✅	✅	✅

Notion chỉ hỗ trợ ba cấp tiêu đề (được gọi là tiêu đề 1, 2 và 3 trong trình soạn thảo của họ, tương ứng với H1H3).

Những sai lầm phổ biến

Quên không gian sau #

#Not a heading    ← Missing space
# This is correct

Khoảng cách giữa # và văn bản tiêu đề được yêu cầu trong CommonMark.

Sử dụng tiêu đề cho phong cách, không phải cấu trúc Sử dụng ### để làm cho văn bản nhỏ hơn một chút mà không phải là một subsection thực sự phá vỡ cấu trúc tài liệu. Thay vào đó, hãy sử dụng văn bản kiểu hoặc lớp CSS.

Quá tổ Nếu bạn cần H5 và H6, hãy xem xét liệu nội dung có nên được chia thành các trang riêng biệt hay không.

FAQ

Sự khác biệt giữa phong cách tiêu đề ATX và Setext là gì? Sử dụng ATX # nhân vật. Setext sử dụng nhấn mạnh (=== đối với H1, --- cho H2). ATX được ưa thích vì nó không rõ ràng và hoạt động cho H1H6.

Tôi có thể có nhiều H2 không? Vâng, đó là tất cả. H2 xác định các phần chính, và một tài liệu thường có một số.

Việc bỏ qua các cấp độ định hướng có ảnh hưởng đến SEO không? Nó ảnh hưởng đến khả năng truy cập nhiều hơn SEO trực tiếp, nhưng một cấu trúc ngữ nghĩa sạch là một tín hiệu tích cực. Các công cụ tìm kiếm thích nội dung có cấu trúc tốt.

Tài liệu chuyển đổi của tôi có tất cả các tiêu đề ở cùng một mức độ. Chuyện gì đã xảy ra? Tài liệu Word sử dụng định dạng thủ công thay vì kiểu tiêu đề. Xem thêm Word đến Markdown Hướng dẫn định dạng để chữa bệnh.

Kết luận

Markdown tiêu đề là đơn giản trong cú pháp nhưng quan trọng trong tác động. Sử dụng H1 một lần như là tiêu đề tài liệu, H2 cho các phần chính, và H3 cho các phần nhỏ. Giữ trật tự thứ tự sạch sẽ, không bỏ qua bất kỳ cấp độ nào và viết văn bản tiêu đề mô tả. Khi chuyển đổi Word tài liệu với WordToMD, đảm bảo nguồn sử dụng Words style tiêu đề tích hợp để chuyển đổi sạch.