หัวข้อเป็นกระดูกสันหลังของเอกสาร Markdown ใด ๆ พวกเขากําหนดโครงสร้าง, ทําให้การเดินเรือ, มีผลกระทบต่อการเข้าถึง, และมีผลกระทบ SEO. คู่มือนี้ครอบคลุมทุกอย่างเกี่ยวกับ Markdown หัวข้อ คําบรรทัด กฎระดับชั้น การแตกต่างของแพลตฟอร์ม และการปฏิบัติที่ดีที่สุด
คําบรรยายหัวข้อ
Markdown หัวข้อใช้ # สัญลักษณ์ (แบบ ATX) จํานวน # ตัวอักษรกําหนดระดับหัวข้อ:
# Heading 1
## Heading 2
### Heading 3
#### Heading 4
##### Heading 5
###### Heading 6
ยังมีรูปแบบ Setext (H1 และ H2 เท่านั้น)
Heading 1
=========
Heading 2
---------
แบบ ATX (#) เป็นที่ชอบ มันชัดเจนกว่า และทํางานสําหรับทั้งหกระดับ
ความหมาย ของ ทุก ระดับ หัวข้อ
| ระดับ | HTML แท็ก | สาขา |
|---|---|---|
| H1 | <h1> | ชื่อหน้าหรือเอกสาร |
| H2 | <h2> | ส่วนใหญ่ |
| H3 | <h3> | ส่วนล่างภายใน H2 |
| H4 | <h4> | อนุภาคใน H3 |
| H5 | <h5> | ไม่ค่อยใช้ในทางปฏิบัติ |
| H6 | <h6> | เกือบไม่เคยจําเป็น |
เอกสารส่วนใหญ่ใช้ H1H3 เท่านั้น H4H6 ปกติแสดงให้เห็นว่าโครงสร้างเอกสารลึกเกินไป
H1: หนึ่งต่อหน้า
หัวข้อ H1 ควรปรากฏครั้งละ Markdown เอกสาร มันแสดงชื่อเอกสารหรือหัวข้อหลักของหน้า
ดี
# How to Convert Word to Markdown
หลีกเลี่ยง:
# Section One
...
# Section Two ← Don't use multiple H1s
เครื่องค้นหาและเครื่องมือการเข้าถึงคาดหวัง H1 เพียงหนึ่งต่อหน้า. H1 หลายตัวทําให้ทั้งสองคนผิดปกติ
กติกาการจัดเรียงตําแหน่งหัวข้อ
เสมอไปตามลําดับ อย่าข้ามระดับ:
ถูกต้อง:
# Document Title
## Section
### Subsection
#### Detail
ไม่ถูกต้อง:
# Document Title
#### Jumped to H4 ← Skips H2 and H3
การข้ามระดับหัวข้อจะทําลายแนวโน้มของเอกสาร และไม่เข้าถึงแนวทางการเข้าถึง WCAG
การแปลง Word หัวข้อเป็น Markdown
เมื่อคุณแปลงเอกสาร Word ด้วย WordToMD, Words รูปแบบหัวข้อที่ตั้งอยู่ในแผนที่โดยตรง:
| Word สไตล์ | Markdown ผลิต |
|---|---|
| หมวด 1 | # Heading |
| หมวด 2 | ## Heading |
| หมวด 3 | ### Heading |
| ปกติ + หนา | **Bold text** (ไม่มีหัวข้อ) |
ปัญหาที่พบกันทั่วไปที่สุด: ผู้เขียนจะขยายขนาดตัวอักษรด้วยมือ แทนที่จะใช้สไตล์ Heading การสร้างข้อความที่ดูเหมือนหัวข้อใน Word แต่เปลี่ยนเป็นข้อความที่เข้มข้นใน Markdown ดู Word ถึง Markdown คู่มือการจัดรูป ว่าเราจะแก้ไขเรื่องนี้ได้อย่างไร
ID หัวข้อและลิงค์แก่น
โปรเซสเซอร์ Markdown ส่วนใหญ่จะสร้าง ID โดยอัตโนมัติจากข้อความหัวข้อ:
## Getting Started
เครื่องผลิต: <h2 id="getting-started">Getting Started</h2>
คุณสามารถเชื่อมต่อมันได้:
See the [Getting Started section](#getting-started).
กติกาสําหรับ ID ที่สร้างโดยอัตโนมัติ
- ตัวอักษรทั้งหมดเป็นตัวเล็ก
- เปลี่ยนช่องว่างด้วยไฟน์
- การตัดตัวอักษรพิเศษเว้นแต่ไพน์
ตัวอย่าง:
## API Reference→#api-reference## What's New?→#whats-new## Step 1: Install→#step-1-install
ตาราง เนื้อหา
สําหรับเอกสารยาว, สร้าง TOC โดยใช้หัวข้อลิงก์:
## Table of Contents
- [Installation](#installation)
- [Configuration](#configuration)
- [Basic Settings](#basic-settings)
- [Advanced Options](#advanced-options)
- [Usage](#usage)
- [FAQ](#faq)
GitHub สร้าง TOC โดยอัตโนมัติในมุมด้านบนซ้ายของไฟล์ Markdown ที่มีหัวข้อ
SEO ความพิจารณา
สําหรับ Markdown ที่ใช้ในเว็บไซต์สแตติก (Jekyll, Hugo, Astro) และเผยแพร่ในเว็บไซต์:
- H1 = ชื่อหน้า ใส่คํากุญแจหลักของคุณ หนึ่งต่อหน้า
- H2s = ส่วนใหญ่ รวมคํากุญแจรองตามธรรมชาติ
- H3s = ภาคล่าง หัวข้อเฉพาะเจาะจงกว่า
- วิธีการติดตั้งการพึ่งพึ่งพึ่งพึ่งพึ่งพึ่งพึ่งพึ่งพึ่งพึ่งพึ่งพึ่งพึ่งพึ่งพึ่งพึ่งพึ่งพึ่งพึ่งพึ่งพึ่งพึ่งพึ่งพึ่งพึ่งพึ่งพึ่งพึ่งพึ่งพึ่งพึ่งพึ่งพึ่งพึ่งพึ่งพึ่งพึ่งพึ่งพึ่งพึ่งพึ่งพึ่งพึ่งพึ่งพึ่งพึ่งพึ่งพึ่งพึ่งพึ่งพึ่งพึ่งพึ่งพึ่งพึ่งพึ่งพึ่ง
- หัวข้อถูกอิงเด็กซ์โดยเครื่องค้นหา ทําให้มันสามารถสแกนได้
ดู Word ไปยัง Static Site Generator สําหรับการเผยแพร่เอกสาร Markdown บนเว็บ
การเข้าถึง
เครื่องอ่านหน้าจอใช้ระดับหัวข้อเพื่อช่วยผู้ใช้เดินทาง แนวทาง:
- อย่าข้ามระดับเส้นทาง (H1 → H3 โดยไม่มี H2)
- อย่าใช้หัวข้อเพียงเพื่อการจัดรูปภาพ (ใช้ bold หรือ CSS แทน)
- ทําให้บทความหัวข้อมีความหมาย หลีกเลี่ยง ภาค 1 ส่วน A
- ให้หัวข้อเป็นสั้น แต่มีคําอธิบาย
การแสดงหัวข้อตามแพลตฟอร์ม
| แพลตฟอร์ม | H1-H6 | อัตโนมัติ ID | อัตโนมัติ TOC |
|---|---|---|---|
| GitHub | ✅ | ✅ | ✅ (ผ่านปุ่ม) |
| Obsidian | ✅ | ✅ | ผ่านโปรแกรม |
| GitBook | ✅ | ✅ | ✅ (ขอบข้าง) |
| Notion | H1-H3 เท่านั้น | ❌ | ❌ |
| VS รูปแบบรหัส | ✅ | ✅ | ❌ |
| Confluence | ✅ | ✅ | ✅ |
Notion สนับสนุนเพียง 3 ระดับหัวข้อ (ที่เรียกว่าหัวข้อ 1, 2 และ 3 ในรัดการของพวกเขา, การสอดคล้องกับ H1H3)
ความ ผิด ที่ บ่อย
ลืมถึงพื้นที่หลัง #
#Not a heading ← Missing space
# This is correct
สเปซระหว่าง # และคํานวณหัวข้อต้องอยู่ใน CommonMark
การใช้หัวข้อสําหรับการออกแบบ, ไม่ใช่โครงสร้าง
การใช้ ### การทําให้ข้อความเล็กน้อยลง โดยไม่ใช้อุปกรณ์ย่อยจริงๆ จะทําลายโครงสร้างเอกสาร ใช้สไตล์เท็กซ์หรือ CSS คลาสแทน
การกักกรงเกิน หากคุณต้องการ H5 และ H6 ลองพิจารณาว่าเนื้อหาควรแบ่งเป็นหน้าที่แยกกันหรือไม่
FAQ
ความแตกต่างระหว่าง ATX และ Setext สไตล์หัวข้อคืออะไร?
การใช้ ATX # ตัวละคร การใช้งานในบทความที่ ?? ยืนยัน (=== สําหรับ H1 --- สําหรับ H2). ATX เป็นตัวเลือก เพราะมันไม่ชัดเจนและทํางานกับ H1H6
ฉันสามารถมี H2s มากมายได้หรือไม่ ใช่ นั่นแหละคือจุดเด่น H2 กําหนดส่วนใหญ่ และเอกสารโดยทั่วไปมีหลายส่วน
การข้ามระดับทิศทางจะส่งผลต่อ SEO ไหม? มันมีผลกระทบต่อการเข้าถึงมากกว่า SEO โดยตรง แต่โครงสร้างเชิงหมายที่สะอาดเป็นสัญญาณบวก เครื่องค้นหาชอบเนื้อหาที่มีโครงสร้างที่ดี
เอกสารที่แปลงของผมมีหัวข้อทั้งหมดในระดับเดียวกัน อะไรผิดพลาด? เอกสาร Word ใช้การจัดรูปแบบด้วยมือ แทนการใช้สไตล์หัวข้อ ดู Word ถึง Markdown คู่มือการจัดรูป สําหรับการแก้ไข
การสรุป
Markdown หัวข้อเป็นง่ายในการประโยค แต่สําคัญในผลกระทบ ใช้ H1 ครั้งหนึ่งเป็นหัวข้อเอกสาร, H2 สําหรับส่วนใหญ่, และ H3 สําหรับส่วนล่าง. จัดการระดับการจัดอันดับให้สะอาด ไม่เลื่อนระดับ และเขียนบทความหัวข้อที่อธิบาย เมื่อแปลงเอกสาร Word ด้วย WordToMD, ยืนยันว่าแหล่งใช้ Words แบบหัวหน้าในระบบเพื่อการแปลงที่สะอาด.