Οριζόντια γραμμή Markdown: διαχωριστικά, κανόνες και συνήθεις διορθώσεις

Για να προσθέσετε μια οριζόντια γραμμή στο Markdown, βάλτε τρεις παύλες σε ξεχωριστή γραμμή, με μια κενή γραμμή πριν και μετά:

Τέλος της πρώτης ενότητας.

---

Αρχή της επόμενης ενότητας.

Το αποτέλεσμα είναι ένα διαχωριστικό ανάμεσα σε δύο παραγράφους. Το Markdown το ονομάζει θεματικό διαχωριστικό· το HTML το αναπαριστά με <hr>. Επικολλήστε το παράδειγμα στην προβολή Markdown για να ελέγξετε το αποδοσμένο έγγραφο.

Τρεις τρόποι γραφής ενός διαχωριστικού

Όλες αυτές οι μορφές δημιουργούν θεματικό διαχωριστικό:

Πηγή Markdown	Αποτέλεσμα
---	Οριζόντια γραμμή
***	Οριζόντια γραμμή
___	Οριζόντια γραμμή
* * *	Οριζόντια γραμμή

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

Ο αριθμός των παυλών δεν ελέγχει το οπτικό πλάτος της γραμμής. Μια γραμμή με 20 παύλες και μια με τρεις παράγουν το ίδιο στοιχείο HTML· το στυλ του προορισμού καθορίζει την εμφάνισή του.

Γιατί η οριζόντια γραμμή έγινε επικεφαλίδα;

Αυτός ο πηγαίος κώδικας δεν τοποθετεί διαχωριστικό κάτω από τις «Σημειώσεις έκδοσης»:

Σημειώσεις έκδοσης
---

Δημιουργεί επικεφαλίδα δεύτερου επιπέδου. Οι παύλες ακριβώς κάτω από κείμενο παραγράφου μπορούν να σχηματίσουν επικεφαλίδα Setext, και αυτή η ερμηνεία προηγείται της οριζόντιας γραμμής. Προσθέστε κενή γραμμή για να τα διαχωρίσετε:

Σημειώσεις έκδοσης

---

Για μια ενότητα εγγράφου, μια ρητή επικεφαλίδα είναι συχνά σαφέστερη:

## Σημειώσεις έκδοσης

Η ροή εισαγωγής δέχεται πλέον αρχεία CSV.

Χρησιμοποιήστε επικεφαλίδες Markdown για να ονομάσετε ενότητες. Χρησιμοποιήστε οριζόντια γραμμή όταν έχει σημασία η ίδια η μετάβαση, όπως στον διαχωρισμό μιας επιστολής από ένα παράρτημα.

Γιατί το διαχωριστικό εμφανίζεται ως απλό κείμενο;

Ελέγξτε την πηγή γύρω από τη γραμμή:

Σύμπτωμα	Πιθανή αιτία	Διόρθωση
Η προεπισκόπηση δείχνει --- σε μπλοκ κώδικα	Τέσσερα κενά στην αρχή ξεχωριστού μπλοκ ή ανοιχτό περίβλημα κώδικα	Αφαιρέστε την εσοχή ή κλείστε το περίβλημα κώδικα
Η προεπισκόπηση δείχνει --	Μόνο δύο παύλες	Χρησιμοποιήστε τρεις ή περισσότερες
Εμφανίζεται κείμενο δίπλα στα σύμβολα	Η γραμμή περιέχει άλλο κείμενο	Βάλτε τα σύμβολα σε ξεχωριστή γραμμή
Η γραμμή εμφανίζεται ως --- μέσα σε πρόταση	Τα σύμβολα είναι μέσα σε ανάστροφους τόνους	Αφαιρέστε τους ανάστροφους τόνους αν θέλετε διαχωριστικό
Η προηγούμενη παράγραφος γίνεται επικεφαλίδα	Δεν υπάρχει κενή γραμμή πάνω από το ---	Εισαγάγετε κενή γραμμή

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

Η οριζόντια γραμμή διαφέρει από την αλλαγή γραμμής

Ένα διαχωριστικό χωρίζει ενότητες. Δεν μεταφέρει απλώς τις επόμενες λέξεις σε νέα γραμμή.

Για μια διεύθυνση, χρησιμοποιήστε υποχρεωτική αλλαγή γραμμής:

Οδός Market 120\
Σαν Φρανσίσκο, Καλιφόρνια

Για νέα παράγραφο, αφήστε κενή γραμμή. Για διαχωριστικό ενότητας, χρησιμοποιήστε --- σε ξεχωριστή γραμμή. Ο οδηγός αλλαγών γραμμής Markdown εξηγεί τα τελικά κενά, τις ανάστροφες καθέτους και τη διαφορετική συμπεριφορά νέων γραμμών του GitHub σε αρχεία και σχόλια.

Τοποθετήστε διαχωριστικό μέσα σε παράθεμα

Διατηρήστε το πρόθεμα > σε κάθε γραμμή, συμπεριλαμβανομένου του διαχωριστικού και των κενών γραμμών:

> Αρχική πρόταση.
>
> ---
>
> Πρόσθετο πλαίσιο από τον αξιολογητή.

Το διαχωριστικό παραμένει μέσα στο παράθεμα. Η αφαίρεση του > από τη γραμμή μπορεί να τερματίσει το παράθεμα και να μεταφέρει το διαχωριστικό στο εξωτερικό επίπεδο του εγγράφου. Δείτε τα παραδείγματα παραθεμάτων για πολλές παραγράφους και ένθετα παραθέματα.

Το διαχωριστικό πίνακα δεν είναι οριζόντια γραμμή

Αυτή η γραμμή ανήκει σε πίνακα:

| Μορφή | Επεξεργάσιμο |
| --- | :---: |
| Markdown | Ναι |

Οι κατακόρυφες γραμμές και οι προαιρετικές άνω και κάτω τελείες περιγράφουν τις στήλες. Δεν εισάγουν διαχωριστικό σε όλο το πλάτος της σελίδας. Χρησιμοποιήστε τον δημιουργό πινάκων Markdown για να δημιουργήσετε πίνακα ή τον μετατροπέα CSV σε Markdown όταν τα δεδομένα υπάρχουν ήδη σε υπολογιστικό φύλλο.

Οριζόντιες γραμμές και εξαγόμενα έγγραφα

Το θεματικό διαχωριστικό δεν είναι εντολή αλλαγής σελίδας. Ένα εργαλείο εξαγωγής PDF ή Word αποφασίζει πού τελειώνουν οι σελίδες με βάση τη διάταξη και τους κανόνες σελιδοποίησης. Μην προσθέτετε επιπλέον παύλες περιμένοντας η επόμενη ενότητα να ξεκινήσει σε νέα σελίδα.

Σε ιστοσελίδα της οποίας ελέγχετε το CSS, το παραγόμενο <hr> μπορεί να μορφοποιηθεί στο φύλλο στυλ του ιστοτόπου. Μια φιλοξενούμενη υπηρεσία Markdown ενδέχεται να μην επιτρέπει προσαρμοσμένο CSS. Ελέγξτε τον τελικό προορισμό ή το εξαγόμενο έγγραφο, ειδικά αν το διαχωριστικό φέρει νόημα που πρέπει να διατηρηθεί στην εκτύπωση.

Συχνές ερωτήσεις

Χρειάζονται κενές γραμμές γύρω από μια οριζόντια γραμμή;

Το CommonMark δεν τις απαιτεί σε κάθε πλαίσιο, αλλά η χρήση τους αποφεύγει τη συνηθισμένη ασάφεια επικεφαλίδας με --- και κάνει τα αρχεία πηγής πιο ευανάγνωστα.

Μπορώ να χρησιμοποιήσω ετικέτα HTML hr;

Το <hr> λειτουργεί σε μηχανές απόδοσης που επιτρέπουν ακατέργαστο HTML. Το --- του Markdown είναι καταλληλότερο για έγγραφο Markdown. Ο επεξεργαστής MD File Viewer αφαιρεί τις ετικέτες HTML που παρέχει ο χρήστης, ενώ η σύνταξη διαχωριστικού Markdown αποδίδεται κανονικά.

Πώς εμφανίζω τρεις παύλες χωρίς να δημιουργήσω διαχωριστικό;

Για παράδειγμα σύνταξης, γράψτε ενσωματωμένο κώδικα: `---`. Για απλό κείμενο σε ξεχωριστή γραμμή, διαφύγετε την πρώτη παύλα: \---.

Για άλλα συνηθισμένα μοτίβα μορφοποίησης, κρατήστε πρόχειρο το σκονάκι Markdown.