Markdown başlık hiyerarşisi nedir?

Markdown başlıkları # sembolü kullanılarak tanımlanır — H1 için bir #, H2 için iki tane, altıya kadar H6 için altı tane. Bir içindekiler tablosuna benzer şekilde, bir belgenin yapısal temelini oluştururlar. İyi yapılandırılmış bir belge, başlıkları mantıksal, iç içe bir sırada kullanır: H1 en üst düzey başlık, H2 ana bölümler, H3 alt bölümler ve bu şekilde devam eder.

Başlıklar sıra dışı kullanıldığında — örneğin, H2'den doğrudan H4'e atlanması — bu, anlamsal taslağı bozar ve erişilebilirliği (ekran okuyucular başlık sırasına bağlıdır) ve SEO'yu (arama motorları başlıkları içerik hiyerarşisini anlamak için kullanır) olumsuz etkileyebilir. Hiyerarşiyi görselleştirmek, bu sorunları yayınlamadan önce tespit etmeyi kolaylaştırır.

Araç açıklaması

Bu araç Markdown metnini ayrıştırır ve tüm # tabanlı başlıkları etkileşimli, daraltılabilir bir ağaç olarak görüntüler. Belgenizin nasıl yapılandırıldığını bir bakışta görebilir, atlanan başlık seviyelerini belirleyebilir ve her türün kaç başlık olduğunu sayabilirsiniz.

Çitlenmiş kod blokları (``` veya ~~~) içindeki başlıklar yoksayılır, bu nedenle çıktı yalnızca gerçek belge yapısını yansıtır.

Örnekler

Giriş:

# Getting Started

## Installation

### Prerequisites

### Steps

## Configuration

# Advanced Usage

## Plugins

Çıktı ağacı:

H1  Getting Started
├── H2  Installation
│   ├── H3  Prerequisites
│   └── H3  Steps
└── H2  Configuration
H1  Advanced Usage
└── H2  Plugins

Özellikler

  • Herhangi bir Markdown metinden tüm H1–H6 başlıklarını ayrıştırır
  • Başlıkları genişlet/daralt kontrolleriyle etkileşimli, daraltılabilir bir ağaç olarak işler
  • Çitlenmiş kod blokları (``` ve ~~~) içindeki başlıkları atlar
  • Seviye başına başlık sayılarını (H1–H6) ve toplam başlık sayısını gösterir
  • Yapılandırılabilir ilk genişletme derinliğini destekler

Kullanım durumları

  • Dokümantasyon incelemesi — Uzun bir README veya dokümantasyon sayfasının yayınlanmadan önce tutarlı, iyi sıralanmış bir başlık yapısına sahip olduğunu kontrol edin.
  • SEO denetimi — Web için tasarlanan içeriğin, arama motoru tarayıcılarının sayfa yapısını anlamasına yardımcı olmak için tek bir H1 ve mantıksal H2/H3 iç içe geçişini kullandığını doğrulayın.
  • Erişilebilirlik kontrolü — Başlık seviyelerinin atlanmadığından emin olun; bu, WCAG yönergeleri tarafından işaretlenen yaygın bir erişilebilirlik sorunudur.

Nasıl çalışır

Araç, Markdown kaynağını satır satır tarar. Bir ila altı # karakteriyle başlayan ve ardından bir boşluk gelen herhangi bir satır, başlık olarak kabul edilir. İki geçişli bir algoritma önce tüm başlıkları sırayla toplar, ardından açık üst düğümlerin bir yığınını izleyerek bir ağaç oluşturur — her yeni başlık, en yakın önceki daha düşük seviye başlığının altına yerleştirilir.

İpuçları

  • Ön madde de dahil olmak üzere tam bir Markdown dosyası yapıştırın — araç başlık olmayan satırları yoksayar, bu nedenle YAML ön maddesi ve gövde metni çıktıyı etkilemez.
  • Derin iç içe geçişi otomatik olarak daraltmak ve önce üst düzey bir genel bakış almak için İlk genişletme derinliği ayarını kullanın.
  • Büyük bir belgeyi keşfetmeye başlamak için daraltılmış olarak başlamak ve belirli bölümlere inmek için Tümünü Genişlet seçeneğinin işaretini kaldırın.