Markdown Headings Guide: H1 sampai H6, Best Practices, dan SEO

Judul adalah tulang punggung dari setiap dokumen Markdown. Mereka mendefinisikan struktur, memungkinkan navigasi, mempengaruhi aksesibilitas, dan mempengaruhi SEO. Panduan ini mencakup semua tentang Markdown judul sintaksis, aturan hierarki, perbedaan platform, dan praktik terbaik.

Sintaksis Judul

Markdown judul menggunakan # simbol (gaya ATX). Jumlah # karakter menentukan tingkat judul:

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

Ada juga gaya Setext (hanya H1 dan H2):

Heading 1
=========

Heading 2
---------

Gaya ATX (#) lebih disukai lebih eksplisit dan berfungsi untuk semua enam tingkat.

Apa Makna Setiap Tingkat Judul?

Tingkat	HTML Tag	Tujuan
H1	`<h1>`	Judul halaman atau dokumen
H2	`<h2>`	Bagian utama
H3	`<h3>`	Subbagian dalam H2
H4	`<h4>`	Sub-subbagian dalam H3
H5	`<h5>`	Jarang digunakan dalam praktek
H6	`<h6>`	Hampir tidak pernah dibutuhkan

Sebagian besar dokumen hanya menggunakan H1H3. H4H6 biasanya menunjukkan struktur dokumen terlalu dalam.

H1: Satu Per Halaman

Judul H1 harus muncul persis sekali per Markdown dokumen. Ini mewakili judul dokumen atau topik utama halaman.

Baiklah.

# How to Convert Word to Markdown

Hindari:

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

Mesin pencari dan alat aksesibilitas mengharapkan satu H1 per halaman. Banyak H1 membingungkan keduanya.

Aturan Hierarki Judul

Selalu maju arah dalam urutan. Jangan melewatkan level:

Benar:

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

Tidak benar:

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

Melewatkan tingkat judul melanggar garis besar dokumen dan gagal pedoman aksesibilitas WCAG.

Mengkonversi Word Judul menjadi Markdown

Ketika Anda mengonversi dokumen Word dengan WordToMD, Words built-in gaya judul peta langsung:

Word Gaya	Markdown Output
Posisi 1	`# Heading`
Posisi 2	`## Heading`
Posisi 3	`### Heading`
Normal + tebal	`Bold text` (TIDAK ada judul)

Masalah yang paling umum: penulis secara manual tebal dan meningkatkan ukuran font alih-alih menerapkan gaya Heading. Ini membuat teks yang terlihat seperti judul di Word tetapi dikonversi menjadi teks tebal biasa di Markdown. Lihat Word ke Markdown Panduan Pemformatan untuk bagaimana memperbaiki ini.

ID Judul dan Anchor Links

Sebagian besar prosesor Markdown secara otomatis menghasilkan ID dari teks judul:

## Getting Started

Generator: <h2 id="getting-started">Getting Started</h2>

Anda dapat menautkan ke:

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

Aturan untuk ID yang dihasilkan secara otomatis:

Huruf kecil semua karakter
Ganti ruang dengan tanda hubung
Karakter khusus strip kecuali tanda hubung

Contoh-contohnya:

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

Daftar Isi

Untuk dokumen panjang, generasikan TOC dengan menggunakan tautan anchor heading:

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

GitHub secara otomatis menghasilkan TOC di sudut kiri atas file Markdown dengan judul.

SEO Pertimbangan

Untuk Markdown yang digunakan di situs statis (Jekyll, Hugo, Astro) dan dipublikasikan di web:

H1 = judul halaman Masukkan kata kunci utama Anda. Satu per halaman.
H2s = bagian utama Masukkan kata kunci sekunder secara alami
H3s = subbagian Topik yang lebih spesifik
Menjaga judul deskriptif Bagaimana cara menginstal dependensi beat Instalasi
Judul diindeks oleh mesin pencari membuatnya dapat di-scan

Lihat Word ke Static Site Generator untuk menerbitkan dokumen Markdown ke web.

Aksesibilitas

Pembaca layar menggunakan hierarki judul untuk membantu pengguna menavigasi. Pedoman:

Jangan melewatkan tingkat arah (H1 → H3 tanpa H2)
Jangan gunakan judul hanya untuk pemformatan visual (menggunakan tebal atau CSS sebagai gantinya)
Membuat teks judul yang bermakna hindari Bagian 1, Bagian A
Simpan judul yang ringkas namun deskriptif

Rendering Judul Per Platform

Platform	H1-H6	ID otomatis	Auto-TOC
GitHub	✅	✅	✅ (melalui tombol)
Obsidian	✅	✅	Melalui plugin
GitBook	✅	✅	✅ (bar samping)
Notion	H1-H3 saja	❌	❌
VS Pratinjau Kode	✅	✅	❌
Confluence	✅	✅	✅

Notion hanya mendukung tiga tingkat judul (disebut judul 1, 2, dan 3 dalam editor mereka, memetakan ke H1H3).

Kesalahan Umum

Melupakan ruang setelah #

#Not a heading    ← Missing space
# This is correct

Ruang antara # dan teks judul diperlukan dalam CommonMark.

Menggunakan judul untuk styling, bukan struktur Menggunakan ### untuk membuat teks sedikit lebih kecil tanpa menjadi subbagian sebenarnya melanggar struktur dokumen. Gunakan teks bergaya atau kelas CSS sebagai gantinya.

Peninggalan yang berlebihan Jika Anda membutuhkan H5 dan H6, pertimbangkan apakah konten harus dibagi menjadi halaman yang terpisah.

FAQ

Apa perbedaan antara gaya judul ATX dan Setext? Penggunaan ATX # karakter. Setext menggunakan menggarisbawahi (=== untuk H1, --- untuk H2). ATX lebih disukai karena tidak ambigu dan berfungsi untuk H1H6.

Bisakah aku punya beberapa H2s? Ya, itulah intinya. H2 mendefinisikan bagian utama, dan sebuah dokumen biasanya memiliki beberapa.

Akankah melompat tingkat arah mempengaruhi SEO? Ini mempengaruhi aksesibilitas lebih dari SEO secara langsung, tetapi struktur semantik yang bersih adalah sinyal positif. Mesin pencari lebih suka konten yang terstruktur dengan baik.

Dokumen saya dikonversi memiliki semua judul pada tingkat yang sama. Apa yang salah? Dokumen Word menggunakan pemformatan manual alih-alih gaya Heading. Lihat Word ke Markdown Panduan Pemformatan untuk obatnya.

Kesimpulan

Markdown judul sederhana dalam sintaksis tetapi penting dalam dampak. Gunakan H1 sekali sebagai judul dokumen, H2 untuk bagian utama, dan H3 untuk subbagian. Jaga hierarki tetap bersih, jangan melewatkan level, dan tuliskan teks judul deskriptif. Saat mengkonversi dokumen Word dengan WordToMD, pastikan sumber menggunakan Words built-in Heading style untuk konversi bersih.