Mikä on Markdown-otsikkohierarkia?

Markdown-otsikot määritellään käyttämällä #-symbolia — yksi # H1:lle, kaksi H2:lle, jopa kuusi H6:lle. Ne muodostavat dokumentin rakenteellisen perustan, samoin kuin sisällysluettelo. Hyvin jäsennelty dokumentti käyttää otsikoita loogisessa, sisäkkäisessä järjestyksessä: H1 ylimmän tason otsikkona, H2 pääosioille, H3 aliosioille ja niin edelleen.

Kun otsikoita käytetään väärässä järjestyksessä — esimerkiksi hyppäämällä H2:sta suoraan H4:ään — se rikkoo semanttisen rakenteen ja voi vahingoittaa saavutettavuutta (näytönlukijat luottavat otsikkojärjestykseen) ja SEO:ta (hakukoneet käyttävät otsikoita sisältöhierarkian ymmärtämiseen). Hierarkian visualisointi helpottaa näiden ongelmien havaitsemista ennen julkaisemista.

Työkalun kuvaus

Tämä työkalu jäsentää Markdown-tekstiä ja näyttää kaikki #-pohjaiset otsikot interaktiivisena, kutistettavana puuna. Näet yhdellä silmäyksellä, kuinka dokumenttisi on jäsennelty, voit tunnistaa ohitetut otsikkotasot ja laskea, kuinka monta kunkin tyyppistä otsikkoa on.

Otsikot suljetuissa koodilohkoissa (``` tai ~~~) jätetään huomiotta, joten tulos heijastaa vain todellista dokumentin rakennetta.

Esimerkit

Syöte:

# Getting Started

## Installation

### Prerequisites

### Steps

## Configuration

# Advanced Usage

## Plugins

Tulostettu puu:

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

Ominaisuudet

  • Jäsentää kaikki H1–H6-otsikot mistä tahansa Markdown-tekstistä
  • Esittää otsikot interaktiivisena, kutistettavana puuna, jossa on laajennus-/kutistuskontrollit
  • Ohittaa otsikot suljetuissa koodilohkoissa (``` ja ~~~)
  • Näyttää otsikkojen määrän tasoa kohti (H1–H6) ja otsikkojen kokonaismäärän
  • Tukee määritettävää alkuperäistä laajennussyvyyttä

Käyttötapaukset

  • Dokumentaation tarkistus — Tarkista, että pitkällä README-tiedostolla tai dokumentaatiosivulla on johdonmukainen, hyvin järjestetty otsikkorakenne ennen julkaisemista.
  • SEO-tarkastus — Varmista, että verkkoon tarkoitettu sisältö käyttää yhtä H1:tä ja loogista H2/H3-sisäkkäisyyttä, jotta hakukoneiden crawlerit ymmärtävät sivun rakenteen.
  • Saavutettavuuden tarkistus — Varmista, että otsikkotasoja ei ohiteta, mikä on yleinen saavutettavuusongelma, jonka WCAG-ohjeet merkitsevät.

Kuinka se toimii

Työkalu skannaa Markdown-lähteen rivi kerrallaan. Mikä tahansa rivi, joka alkaa yhdestä kuuteen #-merkkiin ja välilyöntiin, käsitellään otsikkona. Kaksivaiheinen algoritmi kerää ensin kaikki otsikot järjestyksessä, sitten rakentaa puun seuraamalla avoimien pääsolmujen pinoa — jokainen uusi otsikko sisäkkäistetään lähimmän edellisen alemman tason otsikon alle.

Vinkkejä

  • Liitä koko Markdown-tiedosto, mukaan lukien etumateriaali — työkalu jättää huomiotta rivit, jotka eivät ole otsikoita, joten YAML-etumateriaali ja rungon teksti eivät vaikuta tulokseen.
  • Käytä Alkuperäinen laajennussyvyys -asetusta syvien sisäkkäisyystasojen automaattiseen kutistamiseen ja korkean tason yleiskatsauksen saamiseen ensin.
  • Poista Laajenna kaikki -valinnan merkintä ennen suurten dokumenttien tutkimista, jotta voit aloittaa kutistettuina ja porautua tiettyihin osioihin.