Μορφοποιητής MDX
Συμμαζέψτε έγγραφα MDX με αυτόν τον μορφοποιητή MDX. Επικολλήστε MDX με imports, exports, στοιχεία JSX και Markdown και το εργαλείο αφαιρεί τις εξωτερικές κενές γραμμές του εγγράφου και ευθυγραμμίζει ξανά κάθε πίνακα με κάθετες, συμπληρώνοντας τα κελιά ώστε να έχουν το πλάτος της στήλης τους και δημιουργώντας ξανά τη γραμμή διαχωρισμού με τις άνω και κάτω τελείες ευθυγράμμισης. Τα imports, τα στοιχεία και οι εκφράσεις παραμένουν ακριβώς όπως γράφτηκαν, ώστε οι συντάκτες τεκμηρίωσης να έχουν τακτοποιημένους πίνακες χωρίς να χαλάει η διαδικασία build.
Συχνές ερωτήσεις
Τι αλλάζει ο μορφοποιητής MDX;
Ευθυγραμμίζει ξανά τους πίνακες με κάθετες και αφαιρεί κενές γραμμές και κενά από την αρχή και το τέλος του εγγράφου. Όλα τα υπόλοιπα, συμπεριλαμβανομένου του κειμένου Markdown, των imports, των exports και του JSX, διατηρούνται ακριβώς όπως γράφτηκαν.
Αγγίζονται τα imports, τα exports και τα στοιχεία JSX;
Όχι, οι δηλώσεις import και export, οι ετικέτες στοιχείων όπως <Callout type="info"> και οι εκφράσεις μέσα σε άγκιστρα αντιγράφονται χωρίς αλλαγές. Ο μορφοποιητής δεν αναδιατάσσει ποτέ τον κώδικα, οπότε δεν μπορεί να χαλάσει το build MDX.
Πώς μορφοποιούνται οι πίνακες;
Κάθε γραμμή αποκτά κάθετες στην αρχή και στο τέλος, ενώ κάθε κελί συμπληρώνεται μέχρι το πλάτος του μεγαλύτερου κελιού στη στήλη του, με ελάχιστο πλάτος τριών χαρακτήρων. Η γραμμή διαχωρισμού δημιουργείται ξανά με αντίστοιχες παύλες.
Διατηρούνται οι ευθυγραμμίσεις των πινάκων;
Ναι, διατηρούνται οι άνω και κάτω τελείες ευθυγράμμισης στη γραμμή διαχωρισμού, όπως :---, :---: και ---:. Οι στήλες με αριστερή, κεντρική και δεξιά ευθυγράμμιση αποδίδονται με τον ίδιο τρόπο μετά τη μορφοποίηση.
Αλλάζουν τα μπλοκ κώδικα;
Όχι, το περιεχόμενο ανάμεσα σε φράχτες από τρία backticks ή τρεις περισπωμένες παραμένει όπως είναι. Οι γραμμές με κάθετες μέσα σε μπλοκ κώδικα δεν αντιμετωπίζονται ποτέ ως πίνακες.
Γιατί ορισμένες στήλες πινάκων είναι πιο φαρδιές από το αναμενόμενο;
Τα πλάτη υπολογίζονται σε byte UTF-8, επομένως τα τονισμένα γράμματα και τα emoji μετρούν ως περισσότεροι από ένας χαρακτήρες. Το επιπλέον γέμισμα φαίνεται μόνο στον πηγαίο κώδικα· ο αποδιδόμενος πίνακας φαίνεται ίδιος.
Μορφοποιεί το JavaScript μέσα στο MDX μου;
Όχι, ο κώδικας στα imports, στα exports και στις εκφράσεις δεν μορφοποιείται ξανά. Μορφοποιήστε ξεχωριστά μεγαλύτερα μπλοκ κώδικα με τον μορφοποιητή JavaScript ή JSX.
Ποια είναι η διαφορά από τον μορφοποιητή Markdown;
Και τα δύο εφαρμόζουν τους ίδιους κανόνες· αυτό το εργαλείο επισημαίνει το αποτέλεσμά του ως mdx. Χρησιμοποιήστε το για αρχεία .mdx στο Docusaurus, στο Next.js, στο Astro ή σε παρόμοιες ρυθμίσεις τεκμηρίωσης.
Γιατί το αποτέλεσμα περικλείεται σε μπλοκ κώδικα MDX;
Η έξοδος επιστρέφεται μέσα σε μπλοκ κώδικα με την ένδειξη mdx, ώστε να εμφανίζεται ως πηγαίος κώδικας όταν επικολληθεί στο Markdown. Αντιγράψτε τις γραμμές ανάμεσα στους εξωτερικούς φράχτες στο αρχείο .mdx.
Πόσο μεγάλο μπορεί να είναι το έγγραφό μου;
Έως 5 MB ανά εκτέλεση· μεγαλύτερη είσοδος απορρίπτεται με μήνυμα. Η έξοδος είναι ίδια με την επιλογή MDX του Μορφοποιητή κώδικα.