Δημιουργία πίνακα περιεχομένων Markdown
Δημιουργήστε πίνακα περιεχομένων για ένα έγγραφο Markdown. Επικολλήστε ένα README ή μια σελίδα τεκμηρίωσης, επιλέξτε τα επίπεδα επικεφαλίδων που θα συμπεριληφθούν και λάβετε μια εμφωλευμένη λίστα με συνδέσμους στις άγκυρες κάθε επικεφαλίδας, γραμμένες όπως δημιουργεί το GitHub τα αναγνωριστικά επικεφαλίδων. Οι επικεφαλίδες μέσα σε μπλοκ κώδικα παραλείπονται και στις διπλές επικεφαλίδες προστίθεται αριθμός στις άγκυρες.
Συχνές ερωτήσεις
Πώς δημιουργούνται οι σύνδεσμοι αγκύρωσης;
Με τον ίδιο τρόπο που το GitHub δημιουργεί αναγνωριστικά επικεφαλίδων: το κείμενο της επικεφαλίδας γίνεται πεζό, αφαιρούνται τα σημεία στίξης και τα σύμβολα και τα κενά γίνονται παύλες. Το Getting Started γίνεται #getting-started και το C++ & Rust γίνεται #c--rust.
Τι γίνεται με τις επικεφαλίδες που εμφανίζονται δύο φορές;
Όπως στο GitHub, στην άγκυρα της δεύτερης επικεφαλίδας με το ίδιο κείμενο προστίθεται το -1, στην τρίτη το -2 και ούτω καθεξής, ώστε κάθε σύνδεσμος να οδηγεί στη σωστή ενότητα.
Ποιες επικεφαλίδες αναγνωρίζονται;
Επικεφαλίδες ATX που αρχίζουν με έναν έως έξι χαρακτήρες # και επικεφαλίδες setext με υπογράμμιση = ή -. Οι επικεφαλίδες μέσα σε fenced μπλοκ κώδικα, σε κώδικα με εσοχή και στο front matter YAML αγνοούνται.
Πώς αντιμετωπίζεται η μορφοποίηση μέσα στις επικεφαλίδες;
Από τους συνδέσμους διατηρείται μόνο το κείμενο, από τον ενσωματωμένο κώδικα αφαιρούνται τα backticks, αφαιρούνται τα σημάδια έμφασης και οι ετικέτες HTML, ενώ οι εικόνες παραλείπονται. Τόσο το κείμενο της καταχώρισης όσο και η άγκυρα δημιουργούνται από αυτό το απλό κείμενο.
Ποια επίπεδα επικεφαλίδων περιλαμβάνονται;
Από προεπιλογή, τα επίπεδα 2 και 3, επειδή η επικεφαλίδα επιπέδου 1 είναι συνήθως ο τίτλος του εγγράφου. Ορίστε το χαμηλότερο και το υψηλότερο επίπεδο από το 1 έως το 6. Η λίστα έχει εσοχή ανάλογα με το υψηλότερο επίπεδο που εντοπίστηκε.
Μπορώ να δημιουργήσω αριθμημένη λίστα ή απλό κείμενο;
Ναι. Επιλέξτε αριθμημένη λίστα για να λάβετε 1., 2. και εμφωλευμένη αρίθμηση, ή απενεργοποιήστε τους συνδέσμους για να λάβετε μόνο τα κείμενα των επικεφαλίδων, για παράδειγμα για ένα σχεδιάγραμμα προς εκτύπωση.