Τι είναι μια ιεραρχία επικεφαλίδων Markdown;

Οι επικεφαλίδες Markdown ορίζονται χρησιμοποιώντας το σύμβολο # — ένα # για H1, δύο για H2, έως έξι για H6. Αποτελούν τη δομική ραχοκοκαλιά ενός εγγράφου, παρόμοια με έναν πίνακα περιεχομένων. Ένα καλά δομημένο έγγραφο χρησιμοποιεί επικεφαλίδες σε λογική, ένθετη σειρά: H1 ως τίτλος ανώτατου επιπέδου, H2 για κύριες ενότητες, H3 για υποενότητες, και ούτω καθεξής.

Όταν οι επικεφαλίδες χρησιμοποιούνται εκτός σειράς — για παράδειγμα, άλμα από H2 απευθείας σε H4 — σπάει το σημασιολογικό περίγραμμα και μπορεί να βλάψει την προσβασιμότητα (οι αναγνώστες οθόνης βασίζονται στη σειρά των επικεφαλίδων) και το SEO (οι μηχανές αναζήτησης χρησιμοποιούν επικεφαλίδες για να κατανοήσουν την ιεραρχία περιεχομένου). Η οπτικοποίηση της ιεραρχίας διευκολύνει τον εντοπισμό αυτών των προβλημάτων πριν από τη δημοσίευση.

Περιγραφή εργαλείου

Αυτό το εργαλείο αναλύει κείμενο Markdown και εμφανίζει όλες τις επικεφαλίδες που βασίζονται σε # ως ένα διαδραστικό, δυνατό να συμπτυχθεί δέντρο. Μπορείτε να δείτε με μια ματιά πώς είναι δομημένο το έγγραφό σας, να εντοπίσετε παραλειπόμενα επίπεδα επικεφαλίδων και να μετρήσετε πόσες επικεφαλίδες κάθε τύπου υπάρχουν.

Οι επικεφαλίδες μέσα σε περιφραγμένα μπλοκ κώδικα (``` ή ~~~) αγνοούνται, επομένως η έξοδος αντικατοπτρίζει μόνο την πραγματική δομή του εγγράφου.

Παραδείγματα

Είσοδος:

# Getting Started

## Installation

### Prerequisites

### Steps

## Configuration

# Advanced Usage

## Plugins

Δέντρο εξόδου:

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

Χαρακτηριστικά

  • Αναλύει όλες τις επικεφαλίδες H1–H6 από οποιοδήποτε κείμενο Markdown
  • Αποδίδει επικεφαλίδες ως ένα διαδραστικό, δυνατό να συμπτυχθεί δέντρο με στοιχεία ελέγχου επέκτασης/σύμπτυξης
  • Παραλείπει επικεφαλίδες μέσα σε περιφραγμένα μπλοκ κώδικα (``` και ~~~)
  • Εμφανίζει μετρήσεις επικεφαλίδων ανά επίπεδο (H1–H6) και συνολικό αριθμό επικεφαλίδων
  • Υποστηρίζει ρυθμιζόμενο αρχικό βάθος επέκτασης

Περιπτώσεις χρήσης

  • Ανασκόπηση τεκμηρίωσης — Ελέγξτε ότι ένα μεγάλο README ή σελίδα τεκμηρίωσης έχει συνεπή, καλά διατεταγμένη δομή επικεφαλίδων πριν τη δημοσίευση.
  • Έλεγχος SEO — Επαληθεύστε ότι το περιεχόμενο που προορίζεται για τον ιστό χρησιμοποιεί ένα μόνο H1 και λογική ένθεση H2/H3 για να βοηθήσει τα ρομπότ των μηχανών αναζήτησης να κατανοήσουν τη δομή της σελίδας.
  • Έλεγχος προσβασιμότητας — Βεβαιωθείτε ότι τα επίπεδα επικεφαλίδων δεν παραλείπονται, το οποίο είναι ένα κοινό πρόβλημα προσβασιμότητας που επισημαίνεται από τις κατευθυντήριες γραμμές WCAG.

Πώς λειτουργεί

Το εργαλείο σαρώνει την πηγή Markdown γραμμή προς γραμμή. Οποιαδήποτε γραμμή που ξεκινά με ένα έως έξι χαρακτήρες # ακολουθούμενη από ένα κενό θεωρείται επικεφαλίδα. Ένας αλγόριθμος δύο περασμάτων συλλέγει πρώτα όλες τις επικεφαλίδες με τη σειρά, στη συνέχεια δημιουργεί ένα δέντρο παρακολουθώντας μια στοίβα ανοιχτών γονικών κόμβων — κάθε νέα επικεφαλίδα ένθετη κάτω από την πλησιέστερη προηγούμενη επικεφαλίδα χαμηλότερου επιπέδου.

Συμβουλές

  • Επικολλήστε ένα πλήρες αρχείο Markdown, συμπεριλαμβανομένης της πρώτης ύλης — το εργαλείο αγνοεί τις γραμμές που δεν είναι επικεφαλίδες, επομένως η πρώτη ύλη YAML και το κείμενο του σώματος δεν θα επηρεάσουν την έξοδο.
  • Χρησιμοποιήστε τη ρύθμιση Αρχικό βάθος επέκτασης για αυτόματη σύμπτυξη βαθιών επιπέδων ένθεσης και λήψη μιας ανασκόπησης υψηλού επιπέδου πρώτα.
  • Αποεπιλέξτε Επέκταση όλων πριν εξερευνήσετε ένα μεγάλο έγγραφο για να ξεκινήσετε συμπτυγμένο και να εμβαθύνετε σε συγκεκριμένες ενότητες.