Το Markdown είναι μια μορφή γραφής. Το HTML είναι μια μορφή δημοσίευσης. Έτσι, η σύνταξη Markdown δεν προορίζεται να προσφέρει την πλήρη ευελιξία της HTML, απλώς τα πιο κοινά στοιχεία για γραπτό κείμενο. Όταν χρειάζεται να κάνετε κάτι πιο περίπλοκο, μπορείτε να χρησιμοποιήσετε οποιαδήποτε ενσωματωμένη ετικέτα HTML και ετικέτες σε επίπεδο μπλοκ που υποστηρίζονται από το DevSite σε ένα αρχείο Markdown. Δεν χρειάζεται να υποδείξετε ότι κάνετε εναλλαγή από Markdown σε HTML, απλώς χρησιμοποιήστε την ετικέτα HTML όπως στο παρακάτω παράδειγμα.
This sentence is in Markdown with a <b>bold inline HTML tag</b>.
Ενσωματωμένη HTML
Οι ενσωματωμένες ετικέτες HTML μπορούν να χρησιμοποιηθούν σε μια παράγραφο Markdown, στοιχείο λίστας ή κεφαλίδα και μπορούν επίσης να περιέχουν σύνταξη Markdown (π.χ. **strong** , *emphasis* κ.λπ.) Αυτό είναι χρήσιμο όταν θέλετε να επιστήσετε την προσοχή λίγο κώδικα, όπως στο παρακάτω παράδειγμα.
This is a Markdown paragraph about Java:
<code>System.out.format("The square of *%d* is *%f*.*%n*", i, r);</code>
HTML σε επίπεδο μπλοκ
Οι ετικέτες HTML σε επίπεδο μπλοκ που υποστηρίζονται από το DevSite πρέπει να διαχωρίζονται από το περιβάλλον περιεχόμενο με μια κενή γραμμή. Και σε αντίθεση με τις ενσωματωμένες ετικέτες HTML, η σύνταξη Markdown (π.χ. **strong** , *emphasis* κ.λπ.) στις ετικέτες HTML σε επίπεδο μπλοκ δεν αποδίδεται όπως στο παρακάτω παράδειγμα.
This is a Markdown paragraph that explains Java format strings:
// required blank line
<pre>
System.out.format("The square of *%d* is *%f*.*%n*", i, r);
</pre>
// required blank line
This is another Markdown paragraph.
Βέλτιστες πρακτικές
Συνιστούμε τη μορφοποίηση του HTML σε αρχεία Markdown με τους ακόλουθους τρόπους για την αποφυγή σφαλμάτων απόδοσης στο DevSite.
Μην χρησιμοποιείτε μη υποστηριζόμενες ετικέτες HTML σε επίπεδο μπλοκ Το DevSite υποστηρίζει πολλές ετικέτες HTML σε επίπεδο μπλοκ. αλλά η συμπερίληψη ενός μη υποστηριζόμενου είτε θα αποδώσει το HTML σας ως κείμενο είτε θα σπάσει τον κώδικα.
Μην προσθέτετε επιπλέον καρτέλες ή κενά κατά την εσοχή των ετικετών έναρξης και λήξης σε επίπεδο μπλοκ δεν πρέπει να έχουν εσοχές με καρτέλες ή κενά. Ορισμένοι συντάκτες προσθέτουν αυτόματα επιπλέον καρτέλες ή κενά — προσέξτε!
This is a regular paragraph in Markdown.
<p>
This is an HTML paragraph with proper indentation!
</p>
This is a regular paragraph in Markdown.
Μην ξεχνάτε ότι ο κωδικός χωρίς εσοχή είναι σχετικός
Για παράδειγμα, δεν χρειάζεται να κάνετε εσοχή ετικέτες έναρξης και λήξης σε επίπεδο μπλοκ όταν δημιουργείτε λίστες στο Markdown.
* This is a list item in Markdown
<p>This is an HTML paragraph with proper indentation!</p>
* This is a list item in Markdown
Μην προσθέτετε κενή γραμμή μεταξύ μιας ετικέτας έναρξης και λήξης
Αυτό είναι εύκολο να το κάνετε όταν κάνετε εναλλαγή μεταξύ Markdown και HTML, αλλά μια απλή κενή γραμμή μπορεί εύκολα να αποδώσει μια σελίδα εσφαλμένα.
This is a regular paragraph in Markdown.
<section>
<p>
hello
</p>
<p>
hello
</p>
</section>
This is a regular paragraph in Markdown.