MDX formázó
Tegye rendezettebbé az MDX dokumentumokat ezzel a MDX formázóval. Illesszen be MDX dokumentumot importokkal, exportokkal, JSX komponensekkel és Markdown elemekkel: az eszköz eltávolítja a dokumentum elején és végén lévő üres sorokat, és újraigazít minden függőleges vonalakkal tagolt táblázatot. A cellákat oszlopszélességükhöz igazítja, az elválasztó sort pedig az igazító kettőspontok megtartásával építi újra. Az importok, komponensek és kifejezések pontosan úgy maradnak, ahogy megírta őket, így a dokumentáció szerzői rendezett táblázatokat kapnak a build elrontása nélkül.
Gyakran ismételt kérdések
Mit módosít a MDX formázó?
Újraigazítja a függőleges vonalakkal tagolt táblázatokat, és eltávolítja az üres sorokat, valamint a dokumentum elején és végén lévő szóközöket. Minden más, beleértve a Markdown szöveget, az importokat, exportokat és a JSX elemet, pontosan a megadott formában marad.
Érinti az importokat, exportokat és a JSX komponenseket?
Nem, az import- és exportutasítások, az olyan komponenscímkék, mint a <Callout type="info">, valamint a kapcsos zárójelek közötti kifejezések változatlanul másolódnak át. A formázó soha nem rendezi át a kódot, így nem ronthatja el a MDX buildet.
Hogyan formázza a táblázatokat?
Minden sor elejére és végére függőleges vonal kerül, a cellák pedig az oszlopuk leghosszabb cellájának szélességéhez igazodnak, legalább három karakterre. Az elválasztó sor azonos szélességű kötőjelekkel épül újra.
Megmaradnak a táblázatok igazításai?
Igen, az elválasztó sor igazító kettőspontjai, például a :---, :---: és ---:, megmaradnak. A balra, középre és jobbra igazított oszlopok a formázás után is ugyanúgy jelennek meg.
Módosulnak a kódblokkok?
Nem, a három backtickből vagy három tildejelből álló kerítések közötti tartalom változatlan marad. A kódblokkokban lévő, függőleges vonalakat tartalmazó sorokat soha nem kezeli táblázatként.
Miért szélesebbek egyes táblázatoszlopok a vártnál?
A szélességet UTF-8 bájtokban számítjuk, ezért az ékezetes betűk és az emojik több mint egy karakternek számítanak. A többletkitöltés csak a forrásban látható; a megjelenített táblázat ugyanúgy néz ki.
Formázza a JavaScript elemet a MDX belsejében?
Nem, az importokban, exportokban és kifejezésekben lévő kód nem kerül újraformázásra. A nagyobb kódblokkokat külön formázza a JavaScript vagy a JSX Formatter segítségével.
Miben különbözik a Markdown Formattertől?
Mindkettő ugyanazokat a szabályokat alkalmazza; ez az eszköz mdx-ként jelöli meg az eredményt. Docusaurusban, Next.js-ban, Astro-ben vagy hasonló dokumentációs környezetekben használja .mdx fájlokhoz.
Miért kerül az eredmény mdx kódkeretbe?
A kimenet mdx-ként megjelölt kódblokkban jelenik meg, így forrásként látszik, ha beilleszti a Markdown-ba. Másolja a külső keretek közötti sorokat a .mdx fájlba.
Mekkora lehet a dokumentumom?
Futtatásonként legfeljebb 5 MB; a nagyobb bemenetet a rendszer üzenettel elutasítja. A kimenet megegyezik a Code Formatter MDX beállításának eredményével.