Hva er et Markdown-overskriftshierarki?

Markdown-overskrifter defineres ved hjelp av #-symbolet — en # for H1, to for H2, opp til seks for H6. De danner det strukturelle ryggraden i et dokument, på samme måte som en innholdsfortegnelse. Et godt strukturert dokument bruker overskrifter i en logisk, nestet rekkefølge: H1 som toppnivåtittel, H2 for hovedseksjoner, H3 for underavsnitt, og så videre.

Når overskrifter brukes i feil rekkefølge — for eksempel ved å hoppe fra H2 direkte til H4 — bryter det den semantiske strukturen og kan skade tilgjengeligheten (skjermlesere er avhengige av overskriftsrekkefølgen) og SEO (søkemotorer bruker overskrifter til å forstå innholdshierarkiet). Visualisering av hierarkiet gjør det enkelt å oppdage disse problemene før publisering.

Verktøybeskrivelse

Dette verktøyet analyserer Markdown-tekst og viser alle #-baserte overskrifter som et interaktivt, sammenleggbart tre. Du kan se på et øyeblikk hvordan dokumentet er strukturert, identifisere hoppede overskriftsnivåer, og telle hvor mange overskrifter av hver type som er til stede.

Overskrifter inne i omsluttede kodeblokkene (``` eller ~~~) ignoreres, så utdataene gjenspeiler bare den virkelige dokumentstrukturen.

Eksempler

Inndata:

# Getting Started

## Installation

### Prerequisites

### Steps

## Configuration

# Advanced Usage

## Plugins

Utdattre:

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

Funksjoner

  • Analyserer alle H1–H6-overskrifter fra hvilken som helst Markdown-tekst
  • Gjengir overskrifter som et interaktivt, sammenleggbart tre med utvid-/skjul-kontroller
  • Hopper over overskrifter inne i omsluttede kodeblokkene (``` og ~~~)
  • Viser antall overskrifter per nivå (H1–H6) og totalt antall overskrifter
  • Støtter konfigurerbar innledende utvidelsesdybde

Brukstilfeller

  • Dokumentgjennomgang — Kontroller at en lang README eller dokumentasjonsside har en konsistent, velordnet overskriftsstruktur før publisering.
  • SEO-revisjon — Bekreft at innhold beregnet for nettet bruker en enkelt H1 og logisk H2/H3-nesting for å hjelpe søkemotorkryplere med å forstå sidestrukturen.
  • Tilgjengelighetskontroll — Sikre at overskriftsnivåer ikke hoppes over, noe som er et vanlig tilgjengelighetsproblem flagget av WCAG-retningslinjer.

Hvordan det fungerer

Verktøyet skanner Markdown-kilden linje for linje. Enhver linje som starter med en til seks #-tegn etterfulgt av et mellomrom, behandles som en overskrift. En topassalgoritme samler først alle overskrifter i rekkefølge, og bygger deretter et tre ved å spore en stabel med åpne overordnede noder — hver nye overskrift er nestet under den nærmeste foregående overskriften på et lavere nivå.

Tips

  • Lim inn en fullstendig Markdown-fil, inkludert front matter — verktøyet ignorerer ikke-overskriftslinjer, så YAML front matter og brødtekst vil ikke påvirke utdataene.
  • Bruk innstillingen Innledende utvidelsesdybde til å automatisk skjule dype nestetingsnivåer og få en oversikt på høyt nivå først.
  • Fjern merket for Utvid alle før du utforsker et stort dokument for å starte sammenslått og drille ned i spesifikke seksjoner.