Wat is een Markdown-koppelingshiërarchie?

Markdown-koppelingen worden gedefinieerd met het #-symbool — één # voor H1, twee voor H2, tot zes voor H6. Ze vormen de structurele ruggengraat van een document, vergelijkbaar met een inhoudsopgave. Een goed gestructureerd document gebruikt koppelingen in een logische, geneste volgorde: H1 als de titel op het hoogste niveau, H2 voor grote secties, H3 voor subsecties, enzovoort.

Wanneer koppelingen buiten de juiste volgorde worden gebruikt — bijvoorbeeld door rechtstreeks van H2 naar H4 te springen — wordt de semantische opbouw verbroken en kan dit schadelijk zijn voor toegankelijkheid (schermlezers zijn afhankelijk van de koppelingsvolgorde) en SEO (zoekmachines gebruiken koppelingen om de inhoudshiërarchie te begrijpen). Het visualiseren van de hiërarchie maakt het gemakkelijk om deze problemen vóór publicatie op te sporen.

Gereedschapbeschrijving

Dit gereedschap parseert Markdown-tekst en geeft alle #-gebaseerde koppelingen weer als een interactieve, opvouwbare boom. U kunt in één oogopslag zien hoe uw document is gestructureerd, overgeslagen koppelingsniveaus identificeren en tellen hoeveel koppelingen van elk type aanwezig zijn.

Koppelingen in omheinde codeblokken (``` of ~~~) worden genegeerd, dus de uitvoer weerspiegelt alleen de werkelijke documentstructuur.

Voorbeelden

Invoer:

# Getting Started

## Installation

### Prerequisites

### Steps

## Configuration

# Advanced Usage

## Plugins

Uitvoerboom:

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

Functies

  • Parseert alle H1–H6-koppelingen uit elke Markdown-tekst
  • Geeft koppelingen weer als een interactieve, opvouwbare boom met uit-/invouwbesturingselementen
  • Slaat koppelingen in omheinde codeblokken over (``` en ~~~)
  • Toont koppelingstellingen per niveau (H1–H6) en een totaal aantal koppelingen
  • Ondersteunt configureerbare initiële uitbreidingsdiepte

Gebruiksscenario's

  • Documentatiebeoordeling — Controleer of een lange README of documentatiepagina een consistente, goed geordende koppelingstructuur heeft voordat u deze publiceert.
  • SEO-controle — Verifieer dat inhoud bedoeld voor het web één H1 en logische H2/H3-nesting gebruikt om zoekmachinecrawlers de paginastructuur te helpen begrijpen.
  • Toegankelijkheidscontrole — Zorg ervoor dat koppelingsniveaus niet worden overgeslagen, wat een veelvoorkomend toegankelijkheidsprobleem is dat door WCAG-richtlijnen wordt gemarkeerd.

Hoe het werkt

Het gereedschap scant de Markdown-bron regel voor regel. Elke regel die begint met één tot zes #-tekens gevolgd door een spatie, wordt als een koppeling behandeld. Een algoritme in twee passages verzamelt eerst alle koppelingen in volgorde, bouwt vervolgens een boom door een stack van open bovenliggende knooppunten bij te houden — elke nieuwe koppeling wordt genest onder de dichtstbijzijnde voorafgaande koppeling van een lager niveau.

Tips

  • Plak een volledig Markdown-bestand, inclusief frontmatter — het gereedschap negeert niet-koppelingregels, dus YAML-frontmatter en bodytekst hebben geen invloed op de uitvoer.
  • Gebruik de instelling Initiële uitbreidingsdiepte om diepe nestingniveaus automatisch in te vouwen en eerst een overzicht op hoog niveau te krijgen.
  • Schakel Alles uitvouwen uit voordat u een groot document verkent, om ingevouwen te beginnen en in specifieke secties in te zoomen.