MDX-muotoilija
Siisti MDX-dokumentit tällä MDX-muotoilijalla. Liitä MDX, jossa on tuonteja, vientimäärityksiä, JSX-komponentteja ja Markdown-sisältöä, niin työkalu poistaa dokumentin alun ja lopun tyhjät rivit ja tasaa kaikki pystyviivataulukot uudelleen. Solut täydennetään sarakkeensa levyisiksi, ja erotinrivi luodaan uudelleen kohdistusta osoittavat kaksoispisteet säilyttäen. Tuonnit, komponentit ja lausekkeet säilyvät täsmälleen sellaisina kuin ne on kirjoitettu, joten dokumentaation kirjoittajat saavat siistit taulukot rikkomatta koontia.
Usein kysytyt kysymykset
Mitä MDX-muotoilija muuttaa?
Se tasaa pystyviivataulukot uudelleen ja poistaa tyhjät rivit ja välilyönnit dokumentin alusta ja lopusta. Kaikki muu, kuten Markdown-teksti, tuonnit, vientimääritykset ja JSX-sisältö, säilyy täsmälleen sellaisena kuin se on kirjoitettu.
Käsitelläänkö tuonteja, vientimäärityksiä ja JSX-komponentteja?
Ei, import- ja export-lausekkeet, kuten <Callout type="info">, sekä aaltosulkeissa olevat lausekkeet kopioidaan muuttumattomina. Muotoilija ei koskaan järjestele koodia uudelleen, joten se ei voi rikkoa MDX-koontiasi.
Miten taulukot muotoillaan?
Jokaisen rivin alkuun ja loppuun lisätään pystyviivat, ja jokainen solu täydennetään sarakkeensa leveimmän solun mittaiseksi; vähimmäisleveys on kolme merkkiä. Erotinrivi luodaan uudelleen vastaavan pituisista viivoista.
Säilyvätkö taulukon kohdistukset?
Kyllä, erotinrivin kohdistusta osoittavat kaksoispisteet, kuten :---, :---: ja ---:, säilytetään. Vasemmalle, keskelle ja oikealle kohdistetut sarakkeet renderöityvät samalla tavalla muotoilun jälkeen.
Muuttuvatko koodilohkot?
Ei, kolmen kenoviivan tai kolmen tilde-merkin rajausten välinen sisältö jätetään ennalleen. Koodilohkojen sisällä olevia pystyviivoja sisältäviä rivejä ei koskaan käsitellä taulukoina.
Miksi jotkin taulukon sarakkeet ovat odotettua leveämpiä?
Leveydet lasketaan UTF-8-tavuina, joten aksenttimerkilliset kirjaimet ja emojit vievät enemmän kuin yhden merkin. Ylimääräinen täyte näkyy vain lähdekoodissa; renderöity taulukko näyttää samalta.
Muotoileeko se JavaScript-koodin MDX-elementin sisällä?
Ei, import-, export- ja lausekkeiden koodia ei muotoilla uudelleen. Muotoile suuremmat koodilohkot erikseen JavaScript- tai JSX-muotoilijalla.
Miten tämä eroaa Markdown-muotoilijasta?
Molemmat soveltavat samoja sääntöjä; tämä työkalu merkitsee tuloksensa mdx-muotoiseksi. Käytä sitä .mdx-tiedostoihin Docusauruksessa, Next.js-ympäristössä, Astro-ympäristössä tai vastaavissa dokumentaatioympäristöissä.
Miksi tulos on kääritty mdx-koodiaitaukseen?
Tuloste palautetaan mdx-merkityn koodilohkon sisällä, joten se näkyy lähdekoodina, kun se liitetään kohteeseen Markdown. Kopioi ulompien aitausten väliset rivit .mdx-tiedostoosi.
Kuinka suuri dokumenttini voi olla?
Enintään 5 MB käyttökertaa kohden; suurempi syöte hylätään viestillä. Tuloste on sama kuin Code Formatterin MDX-vaihtoehdon tuloste.