Πώς να το χρησιμοποιήσετε
- Πληκτρολογήστε Markdown στο πρόγραμμα επεξεργασίας ή πατήστε «Δοκιμή παραδείγματος» για να φορτώσετε ένα έγγραφο με πίνακες και μια λίστα εργασιών.
- Δείτε την προεπισκόπηση να ενημερώνεται καθώς πληκτρολογείτε. Μεταβείτε στην «Πηγή HTML» για να δείτε τη σήμανση HTML που δημιουργήθηκε.
- Ενεργοποιήστε ή απενεργοποιήστε το GitHub Flavored Markdown ή τις μεμονωμένες αλλαγές γραμμής, ανάλογα με το πού θα δημοσιευτεί το κείμενο.
- Αντιγράψτε τον κώδικα HTML σε ένα CMS ή email ή κατεβάστε το αποτέλεσμα ως αρχείο .html ή .md.
Πώς λειτουργεί
Το Markdown μετατρέπεται με το marked, έναν ευρέως χρησιμοποιούμενο αναλυτή ανοιχτού κώδικα που ακολουθεί την προδιαγραφή CommonMark και, με την επιλογή GFM ενεργή, το GitHub Flavored Markdown: πίνακες με χαρακτήρες | και στοίχιση στηλών, λίστες εργασιών, ~~διαγραμμένο κείμενο~~ και αυτόματους συνδέσμους για γυμνά URL. Οι υποσημειώσεις, τα μαθηματικά και τα διαγράμματα Mermaid δεν αποτελούν μέρος αυτών των προδιαγραφών και εμφανίζονται ως απλό κείμενο.
Το Markdown μπορεί να περιέχει ακατέργαστο HTML και αυτός ο κώδικας HTML περνά αυτούσιος, όπως κάνουν οι περισσότεροι επεξεργαστές Markdown. Για την ασφάλειά σας, η προεπισκόπηση δεν εισάγεται ποτέ σε αυτήν τη σελίδα. Αποδίδεται μέσα σε απομονωμένο πλαίσιο (sandbox) στο οποίο δεν επιτρέπεται να εκτελεί σενάρια, να υποβάλλει φόρμες, να ανοίγει αναδυόμενα παράθυρα ή να έχει πρόσβαση σε αυτόν τον ιστότοπο· η πολιτική ασφάλειας περιεχομένου του αποκλείει σενάρια, εξωτερικά φύλλα στυλ, γραμματοσειρές και πλαίσια. Μια ετικέτα <script> ή ένα χαρακτηριστικό onclick στο Markdown σας εμφανίζεται στον πηγαίο κώδικα HTML αλλά δεν εκτελείται ποτέ. Οι σύνδεσμοι στην προεπισκόπηση εμφανίζονται αλλά δεν ανοίγουν· αντιγράψτε το URL αν χρειάζεται να ακολουθήσετε κάποιον.
Η προεπισκόπηση χρησιμοποιεί ένα ουδέτερο φύλλο στυλ παρόμοιο με τους συνηθισμένους επεξεργαστές README· ο ιστότοπός σας ή το GitHub ενδέχεται να μορφοποιήσει τον ίδιο κώδικα HTML διαφορετικά. Ο κώδικας HTML που αντιγράφεται είναι το γυμνό τμήμα χωρίς στυλ· το αρχείο .html που κατεβάζετε προσθέτει ένα βασικό φύλλο στυλ, ώστε να μοιάζει με την προεπισκόπηση. Ο κώδικας HTML που κατεβάζετε ή αντιγράφετε δεν υποβάλλεται σε καθαρισμό, επομένως αν περιέχει σενάρια, αυτά θα εκτελεστούν όπου τον επικολλήσετε ή τον ανοίξετε.
Παραδείγματα
Έλεγχος ενός README πριν το push
Επικολλήστε το README.md για να ελέγξετε ότι οι στήλες του πίνακα ευθυγραμμίζονται, η λίστα εργασιών αποδίδεται ως πλαίσια ελέγχου και τα μπλοκ κώδικα οριοθετούνται σωστά, πριν το αρχείο μεταφερθεί στο GitHub.
Γράφοντας για CMS που δέχεται HTML
Συντάξτε μια ανάρτηση ιστολογίου σε Markdown, στη συνέχεια πατήστε «Αντιγραφή HTML» και επικολλήστε τη σήμανση <h2>, <p> και <ul> στον επεξεργαστή HTML του CMS.
Αλλαγές γραμμής τύπου συνομιλίας
Το κείμενο από μια εφαρμογή συνομιλίας έχει γραμμές που χωρίζονται με απλές αλλαγές γραμμής. Ενεργοποιώντας την επιλογή «Αντιμετώπιση απλών αλλαγών γραμμής ως <br>» διατηρεί αυτές τις γραμμές ξεχωριστές αντί να τις ενώνει σε μία παράγραφο.
Συχνές ερωτήσεις
Είναι ασφαλές να επικολλήσω Markdown από άγνωστη πηγή;
Ναι, για προεπισκόπηση. Το αποδοθέν HTML εμφανίζεται σε πλαίσιο τύπου sandbox με απενεργοποιημένα σενάρια, επομένως ακόμη και μια ετικέτα <script> ή ένας χειριστής συμβάντων στο κείμενο δεν κάνει τίποτα εδώ. Προσέξτε πού επικολλάτε το εξαγόμενο HTML, επειδή δεν έχει υποστεί καθαρισμό.
Γιατί δεν εμφανίζονται οι εικόνες μου;
Οι εικόνες από άλλους ιστότοπους αποκλείονται από προεπιλογή, ώστε η προεπισκόπηση να μην πραγματοποιεί αιτήματα δικτύου. Ενεργοποιήστε τη «Φόρτωση εικόνων από άλλους ιστότοπους» για να εμφανιστούν. Σχετικές διαδρομές όπως ./docs/screenshot.png δεν μπορούν να λειτουργήσουν επειδή τα αρχεία δεν βρίσκονται εδώ.
Υποστηρίζει υποσημειώσεις, μαθηματικά ή διαγράμματα;
Όχι. Υποστηρίζει CommonMark και GitHub Flavored Markdown (πίνακες, λίστες εργασιών, διαγραφή κειμένου, αυτόματοι σύνδεσμοι). Οι υποσημειώσεις, τα μαθηματικά LaTeX και τα διαγράμματα Mermaid είναι επεκτάσεις που αυτή η προεπισκόπηση αφήνει ως απλό κείμενο.
Γιατί μια αλλαγή γραμμής δεν ξεκινά νέα γραμμή;
Στο τυπικό Markdown, μια αλλαγή γραμμής μέσα σε μια παράγραφο αντιμετωπίζεται ως κενό. Τερματίστε τη γραμμή με δύο κενά, αφήστε μια κενή γραμμή ή ενεργοποιήστε την επιλογή «Αλλαγές γραμμής ως <br>».
Απόρρητο
Το Markdown μετατρέπεται στο πρόγραμμα περιήγησής σας και δεν μεταφορτώνεται ούτε αποθηκεύεται. Η προεπισκόπηση δεν φορτώνει τίποτα από το διαδίκτυο, εκτός εάν επιτρέψετε εικόνες από άλλους ιστότοπους· σε αυτή την περίπτωση, οι εικόνες ζητούνται απευθείας από τους διακομιστές τους.