Κατάλογος άρθρου
Χαμήλωση τιμήςΤι σημαίνει;
Πώς να χρησιμοποιήσετε τη σύνταξη/σημείωση μορφής Markdown;
ΣΦΑΙΡΙΚΗ ΕΙΚΟΝΑ
Η Markdown είναι μια ελαφριά γλώσσα σήμανσης που δημιουργήθηκε από τον John Gruber.
Επιτρέπει στους ανθρώπους να "γράψουν έγγραφα σε μορφή απλού κειμένου που είναι εύκολο να διαβαστούν και να γραφτούν και στη συνέχεια να τα μετατρέψουν σε έγκυρα έγγραφα XHTML (ή HTML).
Η γλώσσα έχει απορροφήσει πολλά από τα χαρακτηριστικά της σήμανσης απλού κειμένου που βρίσκονται ήδη στο email.
Ο John Gruber δημιούργησε τη γλώσσα Markdown το 2004, σε συνεργασία με τον Aaron Swartz σε μεγάλο βαθμό στη γραμματική.Ο σκοπός της γλώσσας είναι να χρησιμοποιήσει "μια μορφή απλού κειμένου που είναι εύκολο να διαβαστεί, να γραφτεί εύκολα και προαιρετικά να μετατρέπεται σε έγκυρο XHTML (ή HTML)".
σκοπός
Ο στόχος του Markdown είναι να είναι "εύκολο στην ανάγνωση και εύκολη στη γραφή".
αναγνωσιμότητα, κάντε το πάντως网络 营销, η εμπειρία χρήστη είναι πολύ σημαντική.
Ένα έγγραφο γραμμένο σε Markdown θα πρέπει να μπορεί να δημοσιεύεται απευθείας σε απλό κείμενο και δεν πρέπει να φαίνεται ότι αποτελείται από πολλές ετικέτες ή οδηγίες μορφοποίησης.
Η σύνταξη Markdown επηρεάζεται από ορισμένες υπάρχουσες μορφές κειμένου σε HTML, συμπεριλαμβανομένων των Setext, atx, Textile, reStructuredText, Grutatext και EtText, αλλά η μεγαλύτερη πηγή έμπνευσης είναι η μορφή ηλεκτρονικού ταχυδρομείου απλού κειμένου.
Εν ολίγοις, η σύνταξη του Markdown αποτελείται από σύμβολα, τα οποία επιλέγονται προσεκτικά και οι λειτουργίες τους είναι ξεκάθαρες με μια ματιά.Για παράδειγμα: τοποθετήστε αστερίσκους γύρω από το κείμενο για να μοιάζει με *έμφαση*.
Οι λίστες στο Markdown μοιάζουν με λίστες. Τα μπλοκ εισαγωγικά στο Markdown μοιάζουν πραγματικά με την αναφορά ενός κειμένου, όπως ακριβώς έχετε δει στα μηνύματα ηλεκτρονικού ταχυδρομείου.
Συμβατό με HTML
Ο στόχος της γραμματικής Markdown είναι να είναι μια γλώσσα γραφής για τον Ιστό.
Το Markdown δεν προορίζεται να αντικαταστήσει το HTML, ή ακόμα και να το πλησιάσει, έχει πολύ λίγη σύνταξη και αντιστοιχεί σε ένα μικρό υποσύνολο σήμανσης HTML. Το Markdown δεν σχεδιάστηκε για να διευκολύνει τη συγγραφή εγγράφων HTML.
Κατά τη γνώμη μου, η HTML είναι ήδη εύκολο να γραφτεί. Η ιδέα του Markdown είναι να διευκολύνει την ανάγνωση, την εγγραφή και την αλλαγή των εγγράφων κατά βούληση. Η HTML είναι μια μορφή δημοσίευσης, η Markdown είναι μιαΑντιγραφήγραπτή μορφή.Ως εκ τούτου, η σύνταξη μορφοποίησης του Markdown καλύπτει μόνο ό,τι μπορεί το απλό κείμενο.
Οι ετικέτες που δεν καλύπτονται από το Markdown μπορούν να γραφτούν σε HTML απευθείας στο έγγραφοΠροώθηση Ιστούαντίγραφο.Δεν χρειάζεται να το επισημάνετε ως HTML ή Markdown, απλώς προσθέστε τη σήμανση απευθείας.
Μόνο ορισμένα στοιχεία μπλοκ HTML είναι περιορισμένα - όπως π.χ <div>,<table>,<pre>,<p> και άλλες ετικέτες, πρέπει να διαχωρίζονται από άλλες περιοχές περιεχομένου με κενές γραμμές πριν και μετά και οι ετικέτες ανοίγματος και κλεισίματος δεν πρέπει να έχουν εσοχές με καρτέλες ή κενά. Η γεννήτρια Markdown είναι αρκετά έξυπνη ώστε να μην προσθέτει περιττές ετικέτες μπλοκ HTML <p> Επιγραφή.
Το παράδειγμα είναι το ακόλουθο, προσθέτοντας έναν πίνακα HTML στο αρχείο Markdown:
这是一个普通段落。
<table>
<tr>
<td>Foo</td>
</tr>
</table>
这是另一个普通段落。
Σημειώστε ότι η σύνταξη μορφοποίησης Markdown μεταξύ ετικετών μπλοκ HTML δεν θα υποβληθεί σε επεξεργασία.Για παράδειγμα, εάν χρησιμοποιείτε στυλ Markdown μέσα σε μπλοκ HTML*强调*δεν θα έχει αποτέλεσμα.
Ετικέτες ενότητας HTML (ενσωματωμένες) όπως <span>,<cite>,<del> Μπορεί να χρησιμοποιηθεί ελεύθερα σε παραγράφους, λίστες ή επικεφαλίδες Markdown.Σύμφωνα με προσωπικές συνήθειες, μπορείτε ακόμη και να χρησιμοποιήσετε ετικέτες HTML για μορφοποίηση χωρίς τη χρήση της μορφής Markdown.Παράδειγμα: Αν προτιμάτε HTML <a> Ή <img> ετικέτες, οι οποίες μπορούν να χρησιμοποιηθούν απευθείας χωρίς τη σύνταξη συνδέσμου ή ετικετών εικόνας που παρέχεται από το Markdown.
Σε αντίθεση με τις ετικέτες μπλοκ HTML, η σύνταξη Markdown είναι έγκυρη μεταξύ των ετικετών ενοτήτων HTML.
Αυτόματη μετατροπή ειδικών χαρακτήρων
Στα αρχεία HTML, υπάρχουν δύο χαρακτήρες που απαιτούν ειδικό χειρισμό: < 和 & . < τα σύμβολα χρησιμοποιούνται για ετικέτες έναρξης,& Τα σύμβολα χρησιμοποιούνται για την επισήμανση οντοτήτων HTML, εάν θέλετε απλώς να εμφανίσετε το πρωτότυπο αυτών των χαρακτήρων, πρέπει να χρησιμοποιήσετε τη φόρμα οντότητας, όπως < 和 &.
& Οι χαρακτήρες βασανίζουν ιδιαίτερα τους συντάκτες εγγράφων ιστού, αν πρόκειται να πληκτρολογήσετε "AT&T"Πρέπει να γράψεις"AT&T".ενώ στη διεύθυνση URL & Οι χαρακτήρες μετατρέπονται επίσης.Για παράδειγμα, θέλετε να συνδεθείτε με:
http://images.google.com/images?num=30&q=larry+bird
Πρέπει να γράψετε τη μετατροπή URL ως εξής:
http://images.google.com/images?num=30&q=larry+bird
να τοποθετηθεί στην ετικέτα συνδέσμου href σε ακίνητα.Περιττό να πούμε ότι αυτό είναι εύκολο να αγνοηθεί και πιθανώς ο μεγαλύτερος αριθμός σφαλμάτων που εντοπίστηκαν από την επικύρωση προτύπων HTML.
Το Markdown σάς επιτρέπει να γράφετε χαρακτήρες φυσικά και φροντίζει για το τι πρέπει να μετατραπεί.εάν χρησιμοποιείτε & Ένας χαρακτήρας είναι μέρος μιας οντότητας χαρακτήρων HTML, παραμένει ως έχει, διαφορετικά μετατρέπεται σε &;.
Έτσι, εάν θέλετε να εισαγάγετε ένα σύμβολο πνευματικών δικαιωμάτων στο έγγραφο ©, μπορείς να γράψεις:
©
Ο Markdown θα το αφήσει ανέγγιχτο.Και αν γράψεις:
AT&T
Το Markdown θα το μετατρέψει σε:
AT&T
Παρόμοια κατάσταση εμφανίζεται και σε < σημειογραφία, αφού το Markdown επιτρέπει συμβατότητα HTML, αν βάλετε < Τα σύμβολα χρησιμοποιούνται ως οριοθέτες για ετικέτες HTML και το Markdown δεν θα κάνει μετατροπές σε αυτά, αλλά αν γράψετε:
4 < 5
Το Markdown θα το μετατρέψει σε:
4 < 5
Ωστόσο, πρέπει να σημειωθεί ότι εντός του πεδίου εφαρμογής του κώδικα, είτε είναι ενσωματωμένος είτε μπλοκ, < 和 & και τα δύο σύμβολαπρέπειμετατρέπονται σε οντότητες HTML, μια δυνατότητα που σας επιτρέπει να γράφετε εύκολα κώδικα HTML σε Markdown (σε αντίθεση με την HTML, όπου βάζετε όλα τα < 和 & Όλα μετατρέπονται σε οντότητες HTML, προκειμένου να γράψουν κώδικα HTML στο αρχείο HTML. )
στοιχείο μπλοκ
Παράγραφοι και διακοπές γραμμής
Μια παράγραφος Markdown αποτελείται από μία ή περισσότερες διαδοχικές γραμμές κειμένου, τις οποίες προηγούνται και ακολουθούν περισσότερες από μία κενή γραμμή (ο ορισμός της κενή γραμμής είναι ότι φαίνεται να είναι κενή στην οθόνη και θεωρείται κενή γραμμή. Για παράδειγμα, , εάν μια γραμμή περιέχει μόνο κενά και καρτέλες, η γραμμή θα αντιμετωπίζεται επίσης ως κενή γραμμή).Οι κανονικές παράγραφοι δεν πρέπει να έχουν εσοχές με κενά ή καρτέλες.
Η φράση "αποτελείται από μία ή περισσότερες διαδοχικές γραμμές κειμένου" υποδηλώνει στην πραγματικότητα ότι το Markdown επιτρέπει αναγκαστικές νέες γραμμές (εισαγωγή νέων γραμμών) μέσα στις παραγράφους, μια δυνατότητα που διαφέρει από τις περισσότερες άλλες μορφές κειμένου σε HTML (συμπεριλαμβανομένου του τύπου Movable "Convert Line Breaks" " επιλογή), άλλες μορφές θα μετατρέψουν κάθε αλλαγή γραμμής σε <br /> Επιγραφή.
如果 你πράγματιΘέλετε να βασιστείτε στο Markdown για εισαγωγή <br /> Για ετικέτες, πατήστε δύο ή περισσότερα κενά στο σημείο εισαγωγής και, στη συνέχεια, πατήστε Enter.
Πράγματι, χρειάζεται λίγη περισσότερη δουλειά (πρόσθετοι χώροι) για να δημιουργηθεί <br /> , αλλά απλώς "κάθε νέα γραμμή μετατρέπεται σε <br />«Η μέθοδος δεν είναι κατάλληλη στο Markdown, το em στο MarkdownaiΤα μπλοκ εισαγωγικά τύπου L και οι λίστες πολλών παραγράφων είναι όχι μόνο πιο χρήσιμα αλλά και πιο ευανάγνωστα κατά τη στοιχειοθεσία με αλλαγές γραμμής.
Τίτλος
Το Markdown υποστηρίζει δύο συντακτικές για επικεφαλίδες, τύπου Setext και atx-like.
Η φόρμα που μοιάζει με Settext είναι η φόρμα με την κάτω γραμμή, χρησιμοποιώντας = (υψηλότερος τίτλος) και - (Επικεφαλίδες δεύτερης τάξης), για παράδειγμα:
This is an H1
=============
This is an H2
-------------
οποιαδήποτε ποσότητα = 和 - μπορεί να είναι αποτελεσματική.
Η μορφή που μοιάζει με Atx εισάγει το 1 έως το 6 στην αρχή της γραμμής # , που αντιστοιχεί στις επικεφαλίδες 1 έως 6, για παράδειγμα:
# 这是 H1
## 这是 H2
###### 这是 H6
Μπορείτε προαιρετικά να "κλείσετε" επικεφαλίδες τύπου atx, αυτό είναι καθαρά για λόγους αισθητικής, εάν αισθάνεστε άνετα με αυτόν τον τρόπο, μπορείτε να το προσθέσετε στο τέλος της γραμμής #, ενώ οι καταλήξεις των γραμμών # Ο αριθμός δεν χρειάζεται να είναι ίδιος με την αρχή (ο αριθμός των χαρακτήρων λιβρών στην αρχή της γραμμής καθορίζει τη σειρά του τίτλου):
# 这是 H1 #
## 这是 H2 ##
### 这是 H3 ######
Blockquotes Blockquotes
Τα μπλοκ εισαγωγικά σήμανσης Markdown χρησιμοποιούνται παρόμοια με αυτά που χρησιμοποιούνται στο ηλεκτρονικό ταχυδρομείο > των παραπομπών.Εάν είστε εξοικειωμένοι με εισαγωγικά σε γράμματα email, ξέρετε πώς να δημιουργήσετε μια προσφορά μπλοκ σε ένα αρχείο Markdown, το οποίο θα μοιάζει σαν να σπάζετε οι ίδιοι τις γραμμές και μετά να προσθέτετε > :
> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
> consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
> Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
>
> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
> id sem consectetuer libero luctus adipiscing.
Το Markdown σας επιτρέπει επίσης να είστε τεμπέληδες και να προσθέτετε μόνο την πρώτη γραμμή ολόκληρης της παραγράφου > :
> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
id sem consectetuer libero luctus adipiscing.
Οι αναφορές μπλοκ μπορούν να ενσωματωθούν (π.χ.: αναφορές σε αναφορές) προσθέτοντας διαφορετικό αριθμό από > :
> This is the first level of quoting.
>
> > This is nested blockquote.
>
> Back to the first level.
Άλλες συντάξεις Markdown μπορούν επίσης να χρησιμοποιηθούν μέσα σε μπλοκ με εισαγωγικά, συμπεριλαμβανομένων επικεφαλίδων, λιστών, μπλοκ κώδικα κ.λπ.:
> ## 这是一个标题。
>
> 1. 这是第一行列表项。
> 2. 这是第二行列表项。
>
> 给出一些例子代码：
>
> return shell_exec("echo $input | $markdown_script");
Οποιοσδήποτε αξιοπρεπής επεξεργαστής κειμένου μπορεί εύκολα να δημιουργήσει αναφορές σε στυλ email.Για παράδειγμα στο BBEdit μπορείτε να επιλέξετε κείμενο και μετά να επιλέξετε από το μενούαύξηση της ιεραρχίας αναφορών.
列表
Το Markdown υποστηρίζει τόσο ταξινομημένες όσο και μη ταξινομημένες λίστες.
Οι μη ταξινομημένες λίστες χρησιμοποιούν αστερίσκους, σύμβολα συν ή πλην ως δείκτες λίστας:
* Red
* Green
* Blue
Ισοδυναμεί με:
+ Red
+ Green
+ Blue
Επίσης ισοδυναμεί με:
- Red
- Green
- Blue
Οι ταξινομημένες λίστες χρησιμοποιούν αριθμούς ακολουθούμενους από τελεία:
1. Bird
2. McHale
3. Parish
Είναι σημαντικό να σημειωθεί ότι οι αριθμοί που χρησιμοποιείτε στην ετικέτα λίστας δεν επηρεάζουν το HTML εξόδου. Η προκύπτουσα σήμανση HTML για την παραπάνω λίστα θα είναι:
<ol>
<li>Bird</li>
<li>McHale</li>
<li>Parish</li>
</ol>
Εάν η σήμανση της λίστας σας είναι γραμμένη ως:
1. Bird
1. McHale
1. Parish
ή ακόμη και:
3. Bird
1. McHale
8. Parish
Θα λάβετε και οι δύο ακριβώς την ίδια έξοδο HTML.Το θέμα είναι ότι μπορείτε να κάνετε τους αριθμούς της λίστας στο αρχείο Markdown ίδιους με τα αποτελέσματα εξόδου ή αν είστε τεμπέλης, δεν χρειάζεται να σας ενδιαφέρει καθόλου η ορθότητα των αριθμών.
Εάν χρησιμοποιείτε τεμπέλικο γράψιμο, συνιστάται να ξεκινήσετε με 1. για το πρώτο στοιχείο, επειδή το Markdown ενδέχεται να υποστηρίξει το χαρακτηριστικό έναρξης των ταξινομημένων λιστών στο μέλλον.
Η ετικέτα του στοιχείου της λίστας τοποθετείται συνήθως στο αριστερό άκρο, αλλά μπορεί να έχει εσοχή, έως και 3 κενά και η ετικέτα στοιχείου πρέπει να ακολουθείται από τουλάχιστον ένα διάστημα ή καρτέλα.
Για να κάνετε τη λίστα να φαίνεται πιο ωραία, μπορείτε να οργανώσετε τα περιεχόμενα με μια σταθερή εσοχή:
* Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi,
viverra nec, fringilla in, laoreet vitae, risus.
* Donec sit amet nisl. Aliquam semper ipsum sit amet velit.
Suspendisse id sem consectetuer libero luctus adipiscing.
Αλλά αν είστε τεμπέλης, δεν πειράζει επίσης:
* Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi,
viverra nec, fringilla in, laoreet vitae, risus.
* Donec sit amet nisl. Aliquam semper ipsum sit amet velit.
Suspendisse id sem consectetuer libero luctus adipiscing.
Εάν τα στοιχεία της λίστας διαχωρίζονται με κενές γραμμές, το Markdown θα χρησιμοποιήσει το περιεχόμενο του στοιχείου κατά την έξοδο HTML. <p> Οι ετικέτες είναι τυλιγμένες, για παράδειγμα:
* Bird
* Magic
θα μετατραπεί σε:
<ul>
<li>Bird</li>
<li>Magic</li>
</ul>
Αλλά αυτό:
* Bird
* Magic
θα μετατραπεί σε:
<ul>
<li><p>Bird</p></li>
<li><p>Magic</p></li>
</ul>
Τα στοιχεία λίστας μπορούν να περιέχουν πολλές παραγράφους και οι παράγραφοι κάτω από κάθε στοιχείο πρέπει να έχουν εσοχές με 4 κενά ή 1 καρτέλα:
1. This is a list item with two paragraphs. Lorem ipsum dolor
sit amet, consectetuer adipiscing elit. Aliquam hendrerit
mi posuere lectus.
Vestibulum enim wisi, viverra nec, fringilla in, laoreet
vitae, risus. Donec sit amet nisl. Aliquam semper ipsum
sit amet velit.
2. Suspendisse id sem consectetuer libero luctus adipiscing.
Φαίνεται πολύ καλύτερα αν κάνετε εσοχή σε κάθε γραμμή, φυσικά, και πάλι, εάν είστε τεμπέλης, το Markdown επιτρέπει επίσης:
* This is a list item with two paragraphs.
This is the second paragraph in the list item. You're
only required to indent the first line. Lorem ipsum dolor
sit amet, consectetuer adipiscing elit.
* Another item in the same list.
Εάν θέλετε να βάλετε μια αναφορά μέσα σε ένα στοιχείο λίστας, τότε > Πρέπει να έχει εσοχή:
* A list item with a blockquote:
> This is a blockquote
> inside a list item.
Εάν θέλετε να τοποθετήσετε ένα μπλοκ κώδικα, το μπλοκ πρέπει να έχει εσοχήεις διπλούν, που είναι 8 κενά ή 2 καρτέλες:
* 一列表项包含一个列表区块：
<代码写在这>
Φυσικά, μια λίστα στοιχείων θα μπορούσε να δημιουργηθεί κατά λάθος, κάπως έτσι:
1986. What a great season.
Εμφανίζεται δηλαδή στην αρχή της γραμμήςαριθμός-περίοδος-κενό, για να αποφύγετε αυτό, μπορείτε να προσθέσετε μια ανάστροφη κάθετο πριν από την περίοδο.
1986\. What a great season.
μπλοκ κωδικών
Ο πηγαίος κώδικας γραφής ή γλώσσας ετικετών που σχετίζεται με πρόγραμμα έχει συνήθως ήδη στοιχειοθετημένα μπλοκ κώδικα. Συνήθως, δεν θέλουμε αυτά τα μπλοκ να στοιχειοθετούνται όπως τα γενικά αρχεία παραγράφου, αλλά να τα εμφανίζουμε ως έχουν. Το Markdown θα χρησιμοποιήσει <pre> 和 <code> ετικέτες για την αναδίπλωση μπλοκ κώδικα.
Τα δομικά στοιχεία κώδικα στο Markdown είναι τόσο απλή όσο η εσοχή 4 διαστημάτων ή 1 καρτέλας, για παράδειγμα, εισαγάγετε τα εξής:
这是一个普通段落：
这是一个代码区块。
Το Markdown θα μετατραπεί σε:
<p>这是一个普通段落：</p>
<pre><code>这是一个代码区块。
</code></pre>
Αυτή η εσοχή πρώτης τάξης ανά γραμμή (4 κενά ή 1 καρτέλα) καταργείται, για παράδειγμα:
Here is an example of AppleScript:
tell application "Foo"
beep
end tell
θα μετατραπεί σε:
<p>Here is an example of AppleScript:</p>
<pre><code>tell application "Foo"
beep
end tell
</code></pre>
Ένα μπλοκ κώδικα συνεχίζεται μέχρι τη γραμμή χωρίς εσοχή (ή το τέλος του αρχείου).
Μέσα στο μπλοκ κώδικα, & , < 和 > Θα μετατραπεί αυτόματα σε οντότητες HTML. Αυτή η μέθοδος σας διευκολύνει να χρησιμοποιήσετε το Markdown για να εισαγάγετε τον πηγαίο κώδικα HTML για το παράδειγμα, απλώς αντιγράψτε και επικολλήστε τον, προσθέστε εσοχή και το υπόλοιπο Markdown θα το χειριστεί για εσάς, για παράδειγμα:
<div class="footer">
© 2004 Foo Corporation
</div>
θα μετατραπεί σε:
<pre><code><div class="footer">
© 2004 Foo Corporation
</div>
</code></pre>
Στο μπλοκ κώδικα, η γενική σύνταξη Markdown δεν θα μετατραπεί, όπως οι αστερίσκοι είναι απλώς αστερίσκοι, πράγμα που σημαίνει ότι μπορείτε εύκολα να γράψετε αρχεία που σχετίζονται με τη σύνταξη Markdown στη σύνταξη Markdown.
διαχωριστική γραμμή
Μπορείτε να χρησιμοποιήσετε περισσότερους από τρεις αστερίσκους, μείον, υπογράμμιση σε μια γραμμή για να δημιουργήσετε ένα διαχωριστικό, τίποτα άλλο στη γραμμή.Μπορείτε επίσης να εισαγάγετε κενά μεταξύ αστερίσκων ή μείον.Κάθε ένας από τους παρακάτω συμβολισμούς μπορεί να δημιουργήσει ένα διαχωριστικό:
* * *
***
*****
- - -
---------------------------------------
στοιχείο τμήματος
Σύνδεσμος
Το Markdown υποστηρίζει δύο μορφές σύνταξης συνδέσμων: Στη γραμμή和Αναφοράδύο μορφές.
Είτε έτσι είτε αλλιώς, το κείμενο του συνδέσμου επισημαίνεται με [τετράγωνες αγκύλες].
να δημιουργήσετε έναΣτη γραμμήΕάν θέλετε να προσθέσετε το κείμενο τίτλου του συνδέσμου, απλώς τυλίξτε το κείμενο του τίτλου με διπλά εισαγωγικά μετά τη διεύθυνση URL, για παράδειγμα:
This is [an example](http://example.com/ "Title") inline link.
[This link](http://example.net/) has no title attribute.
Θα παράγει:
<p>This is <a href="http://example.com/" title="Title">
an example</a> inline link.</p>
<p><a href="http://example.net/">This link</a> has no
title attribute.</p>
Εάν συνδέεστε με πόρους στον ίδιο κεντρικό υπολογιστή, μπορείτε να χρησιμοποιήσετε σχετικές διαδρομές:
See my [About](/about/) page for details.
ΑναφοράΟ σύνδεσμος ακολουθείται από μια άλλη αγκύλη μετά την παρένθεση του κειμένου του συνδέσμου και το σημάδι που χρησιμοποιείται για την αναγνώριση του συνδέσμου θα πρέπει να συμπληρωθεί στη δεύτερη αγκύλη:
This is [an example][id] reference-style link.
Μπορείτε επίσης να βάλετε προαιρετικά ένα κενό μεταξύ των δύο αγκύλων:
This is [an example] [id] reference-style link.
Στη συνέχεια, οπουδήποτε στο αρχείο, μπορείτε να ορίσετε το περιεχόμενο συνδέσμου αυτής της ετικέτας:
[id]: http://example.com/ "Optional Title Here"
Το περιεχόμενο του συνδέσμου ορίζεται στη μορφή:
- Τετραγωνικές αγκύλες (προαιρετικά πριν από τρία κενά για εσοχή) στις οποίες εισάγεται το κείμενο του συνδέσμου
- ακολουθούμενο από άνω και κάτω τελεία
- ακολουθούμενο από ένα ή περισσότερα κενά ή καρτέλες
- τη διεύθυνση URL του επόμενου συνδέσμου
- Ακολουθήστε προαιρετικά το περιεχόμενο του τίτλου, το οποίο μπορεί να περικλείεται σε μονά εισαγωγικά, διπλά εισαγωγικά ή παρενθέσεις
Οι ορισμοί των παρακάτω τριών συνδέσμων είναι οι ίδιοι:
[foo]: http://example.com/ "Optional Title Here"
[foo]: http://example.com/ 'Optional Title Here'
[foo]: http://example.com/ (Optional Title Here)
Προσοχή:Υπάρχει ένα γνωστό ζήτημα όπου το Markdown.pl 1.0.1 αγνοεί τους τίτλους συνδέσμων που περικλείονται σε μεμονωμένα εισαγωγικά.
Οι διευθύνσεις URL συνδέσμων μπορούν επίσης να περικλείονται σε αγκύλες:
[id]: <http://example.com/> "Optional Title Here"
Μπορείτε επίσης να βάλετε το χαρακτηριστικό τίτλος στην επόμενη γραμμή ή να προσθέσετε κάποια εσοχή, η οποία θα φαίνεται καλύτερα εάν η διεύθυνση URL είναι πολύ μεγάλη:
[id]: http://example.com/longish/path/to/resource/here
"Optional Title Here"
Ο ορισμός της διεύθυνσης URL χρησιμοποιείται μόνο κατά τη δημιουργία του συνδέσμου και δεν εμφανίζεται απευθείας στο αρχείο.
Οι ετικέτες αναγνώρισης συνδέσμων μπορεί να περιέχουν γράμματα, αριθμούς, κενά και σημεία στίξης, αλλά όχιΌχιΈχει διάκριση πεζών-κεφαλαίων, επομένως οι παρακάτω δύο σύνδεσμοι είναι ίδιοι:
[link text][a]
[link text][A]
Ετικέτα σιωπηρού συνδέσμουΤο χαρακτηριστικό σάς επιτρέπει να παραλείψετε τον καθορισμό μιας ετικέτας συνδέσμου. Σε αυτήν την περίπτωση, η ετικέτα συνδέσμου θα αντιμετωπιστεί ως ισοδύναμη με το κείμενο του συνδέσμου. Για να χρησιμοποιήσετε μια σιωπηρή ετικέτα συνδέσμου, απλώς προσθέστε μια κενή αγκύλη μετά το κείμενο του συνδέσμου. Εάν θέλετε "Google " Με τη σύνδεση με το google.com, μπορείτε να απλοποιήσετε:
[Google][]
Στη συνέχεια, ορίστε το περιεχόμενο του συνδέσμου:
[Google]: http://google.com/
Επειδή το κείμενο του συνδέσμου μπορεί να περιέχει κενό διάστημα, αυτή η απλοποιημένη σήμανση μπορεί να περιέχει πολλές λέξεις:
Visit [Daring Fireball][] for more information.
Στη συνέχεια, προχωρήστε για να ορίσετε τη σύνδεση:
[Daring Fireball]: http://daringfireball.net/
Ο ορισμός του συνδέσμου μπορεί να τοποθετηθεί οπουδήποτε μέσα στο αρχείο. Προτιμώ να τον βάλω αμέσως μετά την παράγραφο που εμφανίζεται ο σύνδεσμος. Μπορείτε επίσης να τον βάλετε στο τέλος του αρχείου, σαν σχόλιο.
Ακολουθεί ένα παράδειγμα συνδέσμου αναφοράς:
I get 10 times more traffic from [Google] [1] than from
[Yahoo] [2] or [MSN] [3].
[1]: http://google.com/ "Google"
[2]: http://search.yahoo.com/ "Yahoo Search"
[3]: http://search.msn.com/ "MSN Search"
Εάν το αλλάξετε για να χρησιμοποιήσετε το όνομα του συνδέσμου για να γράψετε:
I get 10 times more traffic from [Google][] than from
[Yahoo][] or [MSN][].
[google]: http://google.com/ "Google"
[yahoo]: http://search.yahoo.com/ "Yahoo Search"
[msn]: http://search.msn.com/ "MSN Search"
Οι παραπάνω δύο τρόποι γραφής θα παράγουν το ακόλουθο HTML.
<p>I get 10 times more traffic from <a href="http://google.com/"
title="Google">Google</a> than from
<a href="http://search.yahoo.com/" title="Yahoo Search">Yahoo</a>
or <a href="http://search.msn.com/" title="MSN Search">MSN</a>.</p>
Ακολουθεί ένα αρχείο Markdown του ίδιου περιεχομένου γραμμένο ενσωματωμένο, που παρέχεται για σύγκριση:
I get 10 times more traffic from [Google](http://google.com/ "Google")
than from [Yahoo](http://search.yahoo.com/ "Yahoo Search") or
[MSN](http://search.msn.com/ "MSN Search").
Στην πραγματικότητα, το θέμα των συνδέσμων σε στυλ αναφοράς δεν είναι ότι είναι ευκολότερο να γραφτεί, αλλά ότι είναι ευκολότερο να διαβαστεί. Συγκρίνετε το παραπάνω παράδειγμα. Το ίδιο το άρθρο σε στυλ αναφοράς έχει μόνο 81 χαρακτήρες, αλλά η ενσωματωμένη φόρμα θα αυξηθεί σε 176 χαρακτήρες. , εάν είναι γραμμένο σε καθαρή μορφή HTML, θα υπάρχουν 234 χαρακτήρες. Σε μορφή HTML, υπάρχουν περισσότερες ετικέτες από το κείμενο.
Χρησιμοποιώντας τους συνδέσμους τύπου αναφοράς του Markdown, μπορείτε να κάνετε το έγγραφο περισσότερο σαν το τελικό αποτέλεσμα του προγράμματος περιήγησης, επιτρέποντάς σας να μετακινήσετε ορισμένα μεταδεδομένα που σχετίζονται με τη σήμανση εκτός του κειμένου της παραγράφου και μπορείτε να προσθέσετε συνδέσμους χωρίς να κάνετε την αίσθηση ανάγνωσης του άρθρου. διακοπή .
τονίζω
Το Markdown χρησιμοποιεί αστερίσκους (*) και η ουσία (_) ως σύμβολο για να επισημάνετε μια υπογραμμισμένη λέξη, είναι * Ή _ Οι περικυκλωμένες λέξεις μετατρέπονται σε <em> περιβάλλεται από ετικέτες, με δύο * Ή _Αν είναι τυλιγμένο, θα μετατραπεί σε <strong>,Για παράδειγμα:
*single asterisks*
_single underscores_
**double asterisks**
__double underscores__
θα μετατραπεί σε:
<em>single asterisks</em>
<em>single underscores</em>
<strong>double asterisks</strong>
<strong>double underscores</strong>
Μπορείτε να χρησιμοποιήσετε όποιο στυλ θέλετε, ο μόνος περιορισμός είναι ότι μπορείτε να ανοίξετε την ετικέτα με το σύμβολο με το οποίο θέλετε να την τελειώσετε.
Η έμφαση μπορεί επίσης να εισαχθεί απευθείας στη μέση του κειμένου:
un*frigging*believable
Όχιαν σας * 和 _ Εάν υπάρχουν κενά και στις δύο πλευρές, αντιμετωπίζονται απλώς ως κανονικά σύμβολα.
Για να εισαγάγετε κανονικούς αστερίσκους ή κάτω παύλες ακριβώς πριν και μετά το κείμενο, μπορείτε να χρησιμοποιήσετε ανάστροφες κάθετες:
\*this text is surrounded by literal asterisks\*
Κώδικας
Εάν θέλετε να επισημάνετε ένα μικρό κομμάτι ενσωματωμένου κώδικα, μπορείτε να το τυλίξετε σε backticks (`),Για παράδειγμα:
Use the `printf()` function.
Θα παράγει:
<p>Use the <code>printf()</code> function.</p>
Εάν θέλετε να εισαγάγετε backtick μέσα σε μια ενότητα κώδικα, μπορείτε να ξεκινήσετε και να ολοκληρώσετε την ενότητα κώδικα με πολλαπλά backtick:
``There is a literal backtick (`) here.``
Αυτή η σύνταξη παράγει:
<p><code>There is a literal backtick (`) here.</code></p>
Μπορείτε να βάλετε ένα κενό στην αρχή και στο τέλος μιας ενότητας κώδικα, ένα μετά την αρχή και ένα πριν από το τέλος, ώστε να εισάγετε backtick στην αρχή της ενότητας:
A single backtick in a code span: `` ` ``
A backtick-delimited string in a code span: `` `foo` ``
Θα παράγει:
<p>A single backtick in a code span: <code>`</code></p>
<p>A backtick-delimited string in a code span: <code>`foo`</code></p>
Μέσα στην ενότητα κωδικών,& και γωνιακοί βραχίονες都θα μετατραπεί αυτόματα σε οντότητες HTML, γεγονός που καθιστά εύκολη την εισαγωγή πηγαίου κώδικα HTML, το Markdown θα βάλει την ακόλουθη παράγραφο:
Please don't use any `<blink>` tags.
προς την:
<p>Please don't use any <code><blink></code> tags.</p>
Μπορείτε επίσης να γράψετε αυτό:
`—` is the decimal-encoded equivalent of `—`.
Για την παραγωγή:
<p><code>—</code> is the decimal-encoded
equivalent of <code>—</code>.</p>
图片
Προφανώς, είναι δύσκολο να σχεδιαστεί μια «φυσική» σύνταξη για την εισαγωγή εικόνων σε μια εφαρμογή μόνο κειμένου.
Το Markdown χρησιμοποιεί μια σύνταξη παρόμοια με τους συνδέσμους για τη σήμανση εικόνων και επιτρέπει επίσης δύο στυλ: Στη γραμμή和Αναφορά.
Η ενσωματωμένη σύνταξη εικόνας μοιάζει με:
Λεπτομέρειες έχουν ως εξής:
- ένα θαυμαστικό
! - ακολουθούμενες από αγκύλες με το εναλλακτικό κείμενο για την εικόνα
- Στη συνέχεια, μια κανονική αγκύλη, βάλτε τη διεύθυνση URL της εικόνας μέσα και, τέλος, τυλίξτε την σε εισαγωγικά και προσθέστε ένα προαιρετικό κείμενο «τίτλου».
Η σύνταξη της εικόνας αναφοράς μοιάζει με αυτό:
![Alt text][id]
"id" είναι το όνομα της αναφοράς εικόνας, η οποία ορίζεται με τον ίδιο τρόπο όπως μια αναφορά συνδέσμου:
[id]: url/to/image "Optional title attribute"
Μέχρι στιγμής, το Markdown δεν έχει τρόπο να καθορίσει το πλάτος και το ύψος της εικόνας, εάν χρειάζεστε, μπορείτε να χρησιμοποιήσετε το κανονικό <img> Επιγραφή.
其它
αυτόματη σύνδεση
Το Markdown υποστηρίζει την επεξεργασία διευθύνσεων URL και γραμματοκιβωτίων email με τη μορφή σχετικά σύντομων αυτόματων συνδέσμων. Εφόσον περικλείονται σε αγκύλες, το Markdown θα το μετατρέψει αυτόματα σε σύνδεσμο.Το κείμενο συνδέσμου της γενικής διεύθυνσης URL είναι το ίδιο με τη διεύθυνση συνδέσμου, για παράδειγμα:
<http://example.com/>
Το Markdown θα μετατραπεί σε:
<a href="http://example.com/">http://example.com/</a>
Η αυτόματη σύνδεση των διευθύνσεων email είναι επίσης παρόμοια, εκτός από το ότι το Markdown θα εκτελέσει πρώτα μια διαδικασία μετατροπής κωδικοποίησης, μετατρέποντας χαρακτήρες κειμένου σε δεκαεξαδικές οντότητες HTML. Αυτή η μορφή μπορεί να ξεγελάσει ορισμένα κακά ρομπότ συλλογής διευθύνσεων email, όπως:
<[email protected]>
Το Markdown θα μετατραπεί σε:
<a href="mailto:addre
[email protected]
m">address@exa
mple.com</a>
Στο πρόγραμμα περιήγησης, αυτή η συμβολοσειρά (στην πραγματικότητα <a href="mailto:[email protected]">[email protected]</a>) γίνεται σύνδεσμος "[email protected]" με δυνατότητα κλικ.
(Αν και αυτή η προσέγγιση μπορεί να ξεγελάσει πολλά ρομπότ, δεν μπορεί να τα σταματήσει όλα, αλλά είναι καλύτερα από το τίποτα. Σε κάθε περίπτωση, το άνοιγμα του γραμματοκιβωτίου σας θα προσελκύσει τελικά διαφημιστικές επιστολές.)
ανάστροφη κάθετο
Το Markdown μπορεί να χρησιμοποιήσει ανάστροφες κάθετες για να εισαγάγει σύμβολα που έχουν άλλη σημασία στη γραμματική, για παράδειγμα: εάν θέλετε να προσθέσετε έναν αστερίσκο δίπλα στο κείμενο για έμφαση (αλλά όχι <em> ετικέτα), μπορείτε να προηγηθείτε του αστερίσκου με ανάστροφη κάθετο:
\*literal asterisks\*
Το Markdown υποστηρίζει τα ακόλουθα σύμβολα πριν από μια ανάστροφη κάθετο για να βοηθήσει στην εισαγωγή κοινών συμβόλων:
\ 反斜线
` 反引号
* 星号
_ 底线
{} 花括号
[] 方括号
() 括弧
# 井字号
+ 加号
- 减号
. 英文句点
! 惊叹号Δωρεάν πρόγραμμα επεξεργασίας Markdown
πλατφόρμα Windows
Πλατφόρμα Mac
διαδικτυακός συντάκτης
προσθήκη προγράμματος περιήγησης
*** Εάν υπάρχει καλύτερο δωρεάν πρόγραμμα επεξεργασίας Markdown για να προτείνετε, δώστε προσοχή στα σχόλιαChen Weiliang,Ευχαριστώ!
Ιστολόγιο Hope Chen Weiliang ( https://www.chenweiliang.com/ ) κοινοποίησε "Τι σημαίνει Markdown; Πώς να χρησιμοποιήσετε τη σύνταξη/σημείωση μορφής Markdown; , για να σε βοηθησω.
Καλώς ήρθατε να μοιραστείτε τον σύνδεσμο αυτού του άρθρου:https://www.chenweiliang.com/cwl-482.html
Καλώς ήρθατε στο κανάλι Telegram του ιστολογίου του Chen Weiliang για να λαμβάνετε τις τελευταίες ενημερώσεις!
📚 Αυτός ο οδηγός περιέχει τεράστια αξία, 🌟Αυτή είναι μια σπάνια ευκαιρία, μην τη χάσετε! ⏰⌛💨
Κοινοποιήστε και κάντε like αν σας αρέσει!
Η κοινή χρήση και τα like σας είναι το συνεχές μας κίνητρο!