Αναφορά Markdown Q&A της Microsoft
Οι Ερωτήσεις και απαντήσεις της Microsoft υποστηρίζουν μια εμπειρία προγράμματος επεξεργασίας εμπλουτισμένου web, επομένως δεν χρειάζεται ποτέ να ανησυχείτε για την επεξεργασία του περιεχομένου στο Markdown. Στην περίπτωση που το κάνετε, ακολουθεί μια αναφορά για τη σύνταξη Markdown για ερωτήσεις και απαντήσεις.
Το Markdown είναι μια απλή γλώσσα σήμανσης με σύνταξη μορφοποίησης απλού κειμένου.
learn.microsoft.com
(Εκμάθηση) το commonMark συμβατό Markdown αναλύεται μέσω του μηχανισμού ανάλυσης Markdig . Η Εκμάθηση και οι Ερωτήσεις και απαντήσεις υποστηρίζουν επίσης προσαρμοσμένες επεκτάσεις Markdown που παρέχουν πλουσιότερο περιεχόμενο στην τοποθεσία. Οι Ερωτήσεις και απαντήσεις χρησιμοποιούν ένα υποσύνολο των επεκτάσεων που υποστηρίζονται στην τεκμηρίωση του Learn. Αυτό το άρθρο παρέχει μια αλφαβητική αναφορά.
Μπορείτε να δείτε περισσότερες πληροφορίες στο άρθρο Αναφορά Learn Markdown.
Τμήματα κώδικα
Παράθεση αποσπάσματος
> This example is a blockquote. It's usually rendered indented and with a different background color.
Το προηγούμενο παράδειγμα αποδίδεται ως εξής:
Αυτό είναι παράθεση αποσπάσματος. Συνήθως αποδίδεται με εσοχή και με διαφορετικό χρώμα φόντου.
Στοιχεία επιπέδου μπλοκ κώδικα
Μπορείτε να προσθέσετε τη γλώσσα κώδικα σε ένα μπλοκ κώδικα για πιο εμπλουτισμένο αποτέλεσμα.
```csharp
public static void Log(string message)
{
_logger.LogInformation(message);
}
```
Το προηγούμενο παράδειγμα αποδίδεται ως εξής:
public static void Log(string message)
{
_logger.LogInformation(message);
}
Emojis
Οι ερωτήσεις και απαντήσεις θα μετατρέψουν έναν σύντομο κώδικα emoji στους αντίστοιχους χαρακτήρες Unicode:
This is a test with a :).
Το προηγούμενο παράδειγμα αποδίδεται ως εξής:
Αυτή είναι μια δοκιμή με .😃
Μορφοποίηση
Για να μορφοποιήσετε κείμενο με έντονη γραφή, περικλείστε το με δύο αστερίσκους:
This text is **bold**.
Για να μορφοποιήσετε κείμενο με πλάγια γραφή, περικλείστε το με έναν αστερίσκο:
This text is *italic*.
Για να μορφοποιήσετε κείμενο με έντονη και πλάγια γραφή, περικλείστε το με τρεις αστερίσκους:
This text is both ***bold and italic***.
Για να μορφοποιήσετε κείμενο ως διαγραφή, περικλείστε το με δύο περικλείστε το με δύο περιοχές:
This text is ~~strikeout~~.
Κεφαλίδες
Οι Ε&Α υποστηρίζουν έξι επίπεδα επικεφαλίδων Markdown:
# This is a first level heading (H1)
## This is a second level heading (H2)
...
###### This is a sixth level heading (H6)
- Πρέπει να υπάρχει ένα κενό διάστημα μεταξύ του τελευταίου
#
και του κειμένου επικεφαλίδας. - Κάθε ερώτηση, απάντηση ή σχόλιο πρέπει να έχει μία και μοναδική επικεφαλίδα H1.
HTML
Εάν εισαγάγετε περιεχόμενο HTML, δεν θα αποδοθεί περιεχόμενο. Αντί για αυτό, θα εμφανίζεται ως απλό κείμενο.
Εικόνες
Η προσαρμοσμένη :::image:::
επέκταση Learn υποστηρίζει τυπικές εικόνες, σύνθετες εικόνες και εικονίδια.
:::image source="<folderOrURLPath>" alt-text="<alt text>":::
Όπου <alt text>
το είναι μια σύντομη περιγραφή της εικόνας και <folderOrURLPath>
είναι μια σχετική διαδρομή προς την εικόνα ή τη διεύθυνση URL της. Το εναλλακτικό κείμενο απαιτείται για τα προγράμματα ανάγνωσης οθόνης για τα άτομα με προβλήματα οράσεως. Είναι επίσης χρήσιμο όταν υπάρχει κάποιο σφάλμα στην τοποθεσία και η δεν είναι δυνατή η απόδοση της εικόνας. Μην αντιγράφετε ονόματα αρχείων για χρήση ως εναλλακτικό κείμενο. Για παράδειγμα, αντί για αυτό:
:::image source="./media/bogusfilename/ADextension_2FA_Configure_Step4.PNG" alt-text="ADextension_2FA_Configure_Step4":::
Γράψτε αυτό:
:::image source="./media/bogusfilename/ADextension_2FA_Configure_Step4.PNG" alt-text="Active Directory extension for two-factor authentication, step 4: Configure":::
Συνδέσεις
Είναι εύκολο να προσθέσετε συνδέσεις στις Ερωτήσεις και απαντήσεις. Οι συνδέσεις οδηγούν τους χρήστες σε περιεχόμενο σε μια άλλη σελίδα στις Ερωτήσεις και απαντήσεις ή σε μια άλλη αξιόπιστη προέλευση.
[Link text](<FullURL>).
[Microsoft Q&A products page](/answers/products).`
Κείμενο σύνδεσης
Οι λέξεις που συμπεριλαμβάνετε στο κείμενο σύνδεσης θα πρέπει να είναι φιλικές. Με άλλα λόγια, θα πρέπει να είναι κανονικές αγγλικές λέξεις ή ο τίτλος της σελίδας στην οποία συνδέεστε.
Μην χρησιμοποιείτε την επιλογή "select here." για το "Κείμενο σύνδεσης". Δεν ενδείκνυται για τη βελτιστοποίηση μηχανισμού αναζήτησης και δεν περιγράφει επαρκώς τον προορισμό.
Σημαντικό
Όλες οι συνδέσεις πρέπει να είναι ασφαλείς (https
έναντι http
) όποτε υπάρχει η σχετική υποστήριξη από τον προορισμό (υπάρχει από τη συντριπτική πλειονότητα).
Παράδειγμα:
For more information, see the [Microsoft Q&A products page](/answers/products).
Το παραπάνω παράδειγμα αποδίδεται ως:
Για περισσότερες πληροφορίες, ανατρέξτε στη σελίδα προϊόντων Ε&Α της Microsoft.
Αυτόματες συνδέσεις
Οι συνδέσεις θα μορφοποιηθούν αυτόματα για οποιαδήποτε συμβολοσειρά που ξεκινά από: https://
, https://
, ftp://
, mailto:
, tel:
ή www.
(επιλύεται σε https://www
.)
Λίστες (αριθμημένες, με κουκκίδες)
Αριθμημένη λίστα
Για να δημιουργήσετε μια αριθμημένη λίστα, μπορείτε να χρησιμοποιήσετε όλους τους αριθμούς. Οι αριθμοί αποδίδονται σε αύξουσα σειρά ως διαδοχική λίστα κατά τη δημοσίευση. Για αυξημένη αναγνωσιμότητα της προέλευσης, μπορείτε να αυξήσετε τις λίστες σας με μη αυτόματο τρόπο.
Μην χρησιμοποιείτε γράμματα στις λίστες, συμπεριλαμβανομένων των ενσωματωμένων λιστών. Δεν αποδίδονται σωστά όταν δημοσιεύονται. Οι ενσωματωμένες λίστες που χρησιμοποιούν αριθμούς θα αποδοθούν ως πεζά γράμματα κατά τη δημοσίευση. Για παράδειγμα:
1. This is
1. a parent numbered list
1. and this is
1. a nested numbered list
1. (fin)
Αυτό αποδίδεται ως εξής:
- Αυτό είναι
- μια γονική αριθμημένη λίστα
- και αυτό είναι
- μια ενσωματωμένη αριθμημένη λίστα
- (τέλος)
Λίστα με κουκκίδες
Για να δημιουργήσετε μια λίστα με κουκκίδες, χρησιμοποιήστε -
ή *
ακολουθούμενο από ένα διάστημα στην αρχή κάθε γραμμής:
- This is
- a parent bulleted list
- and this is
- a nested bulleted list
- All done!
Αυτό αποδίδεται ως εξής:
- Αυτό είναι
- μια γονική λίστα με κουκκίδες
- και αυτό είναι
- μια ενσωματωμένη λίστα με κουκκίδες
- Τέλος!
Όποια σύνταξη και αν χρησιμοποιείτε ή -
*
, χρησιμοποιήστε την με συνέπεια στο περιεχόμενό σας.
Πίνακες
Ο απλούστερος τρόπος για τη δημιουργία ενός πίνακα στο Markdown είναι η χρήση καθέτων και γραμμών. Για να δημιουργήσετε έναν τυπικό πίνακα με μια κεφαλίδα, συνεχίστε μετά την πρώτη γραμμή με διακεκομμένη γραμμή:
|This is |a simple |table header|
|----------|-----------|------------|
|table |data |here |
|it doesn't|actually |have to line up nicely!|
Αυτό αποδίδεται ως εξής:
Αυτό είναι | μια απλή | κεφαλίδα πίνακα |
---|---|---|
πίνακας | δεδομένων | εδώ |
δεν είναι | απαραίτητο | να ευθυγραμμίζεται σωστά! |