MDX formatuoklis
Sutvarkykite MDX dokumentus naudodami šį MDX formatuoklį. Įklijuokite MDX su importais, eksportais, JSX komponentais ir Markdown. Įrankis pašalins tuščias eilutes dokumento pradžioje ir pabaigoje bei iš naujo sulygiuos kiekvieną lentelę su vertikaliais brūkšniais: langeliai bus papildyti tarpais iki stulpelio pločio, o skirtuko eilutė atkurta išsaugant lygiavimo dvitaškius. Importai, komponentai ir išraiškos liks tiksliai taip, kaip parašyta, todėl dokumentacijos autoriai gaus tvarkingas lenteles nepažeisdami kūrimo proceso.
Dažnai užduodami klausimai
Ką pakeičia MDX formatuoklis?
Jis iš naujo sulygiuoja lenteles su vertikaliais brūkšniais ir pašalina tuščias eilutes bei tarpus dokumento pradžioje ir pabaigoje. Visa kita, įskaitant Markdown tekstą, importus, eksportus ir JSX, išsaugoma tiksliai taip, kaip parašyta.
Ar keičiami importai, eksportai ir JSX komponentai?
Ne, importo ir eksporto sakiniai, komponentų žymos, pavyzdžiui, <Callout type="info">, ir išraiškos riestiniuose skliaustuose kopijuojami nepakeisti. Formatuoklis niekada neperdėlioja kodo eilučių, todėl negali sugadinti jūsų MDX kūrimo proceso.
Kaip formatuojamos lentelės?
Kiekvienos eilutės pradžioje ir pabaigoje įrašomi vertikalūs brūkšniai, o kiekvienas langelis papildomas tarpais iki plačiausio langelio stulpelyje pločio, kuris yra bent trys simboliai. Skirtuko eilutė atkuriama naudojant atitinkamą brūkšnių skaičių.
Ar išsaugomas lentelių lygiavimas?
Taip, skirtuko eilutės lygiavimo dvitaškiai, pavyzdžiui, :---, :---: ir ---:, išsaugomi. Kairiuoju, centruotu ir dešiniuoju lygiavimu išdėstyti stulpeliai po formatavimo atvaizduojami taip pat.
Ar keičiami kodo blokai?
Ne, turinys tarp trijų riestinių brūkšnių arba trijų tildžių aptvėrimo ženklų paliekamas nepakeistas. Eilutės su vertikaliais brūkšniais kodo blokuose niekada nelaikomos lentelėmis.
Kodėl kai kurie lentelės stulpeliai platesni, nei tikėtasi?
Stulpelių plotis skaičiuojamas UTF-8 baitais, todėl raidės su diakritiniais ženklais ir jaustukai skaičiuojami kaip daugiau nei vienas simbolis. Papildomas užpildas matomas tik šaltinyje; atvaizduota lentelė atrodo taip pat.
Ar jis formatuoja JavaScript, esantį mano MDX?
Ne, importų, eksportų ir išraiškų kodas neperformatuojamas. Didesnius kodo blokus formatuokite atskirai naudodami JavaScript arba JSX formatavimo įrankį.
Kuo jis skiriasi nuo Markdown formatavimo įrankio?
Abu taiko tas pačias taisykles; šis įrankis rezultatą pažymi kaip mdx. Naudokite jį .mdx failams Docusaurus, Next.js, Astro ar panašiose dokumentacijos sistemose.
Kodėl rezultatas įterptas į mdx kodo bloką?
Išvestis pateikiama kodo bloke, pažymėtame mdx, todėl įklijavus į Markdown ji rodoma kaip šaltinis. Nukopijuokite eilutes tarp išorinių aptvėrimo eilučių į savo .mdx failą.
Kokio dydžio gali būti dokumentas?
Vienai operacijai leidžiama iki 5 MB; didesnė įvestis atmetama pateikiant pranešimą. Išvestis tokia pati kaip Code Formatter parinkties MDX rezultatas.