Vad är en Markdown-rubrikhierarki?

Markdown-rubriker definieras med symbolen # — en # för H1, två för H2, upp till sex för H6. De utgör det strukturella ryggraden i ett dokument, ungefär som en innehållsförteckning. Ett väl strukturerat dokument använder rubriker i en logisk, kapslad ordning: H1 som toppnivåtitel, H2 för huvudavsnitt, H3 för underavsnitt och så vidare.

När rubriker används i fel ordning — till exempel genom att hoppa från H2 direkt till H4 — bryter det den semantiska strukturen och kan skada tillgängligheten (skärmläsare förlitar sig på rubrikordning) och SEO (sökmotorer använder rubriker för att förstå innehållshierarkin). Att visualisera hierarkin gör det enkelt att upptäcka dessa problem innan publicering.

Verktygsbeskrivning

Det här verktyget tolkar Markdown-text och visar alla #-baserade rubriker som ett interaktivt, hopfällbart träd. Du kan snabbt se hur ditt dokument är strukturerat, identifiera överhoppade rubriknivåer och räkna hur många rubriker av varje typ som finns.

Rubriker inuti avgränsade kodblock (``` eller ~~~) ignoreras, så utdatan återspeglar endast den verkliga dokumentstrukturen.

Exempel

Inmatning:

# Getting Started

## Installation

### Prerequisites

### Steps

## Configuration

# Advanced Usage

## Plugins

Utdataträd:

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

Funktioner

  • Tolkar alla H1–H6-rubriker från valfri Markdown-text
  • Renderar rubriker som ett interaktivt, hopfällbart träd med expandera/komprimera-kontroller
  • Hoppar över rubriker inuti avgränsade kodblock (``` och ~~~)
  • Visar rubrikantal per nivå (H1–H6) och ett totalt rubrikantal
  • Stöder konfigurerbar initial expansionsdjup

Användningsfall

  • Dokumentgranskning — Kontrollera att en lång README eller dokumentationssida har en konsekvent, väl ordnad rubrikstruktur innan publicering.
  • SEO-granskning — Verifiera att innehål avsett för webben använder en enda H1 och logisk H2/H3-kapsling för att hjälpa sökmotorkrypare att förstå sidstrukturen.
  • Tillgänglighetskontroll — Se till att rubriknivåer inte hoppas över, vilket är ett vanligt tillgänglighetsproblem som flaggas av WCAG-riktlinjer.

Hur det fungerar

Verktyget skannar Markdown-källan rad för rad. Alla rader som börjar med ett till sex #-tecken följt av ett mellanslag behandlas som en rubrik. En tvåpassalgoritm samlar först alla rubriker i ordning och bygger sedan ett träd genom att spåra en stack med öppna överordnade noder — varje ny rubrik kapslas under den närmaste föregående rubriken på en lägre nivå.

Tips

  • Klistra in en fullständig Markdown-fil, inklusive frontmatter — verktyget ignorerar icke-rubrikrader, så YAML frontmatter och brödtext påverkar inte utdatan.
  • Använd inställningen Initial expansion depth för att automatiskt komprimera djupa kapslingsnivåer och få en överblick på hög nivå först.
  • Avmarkera Expand All innan du utforskar ett stort dokument för att börja komprimerat och borra ner i specifika avsnitt.