Opas: Muunna ja vie Markdown HTML-verkkosivuksi

Voit muuntaa aktiivisen asiakirjasi tyylikkääksi, itsenäiseksi .html-tiedostoksi, jota voit lukea milloin tahansa, missä tahansa ja millä tahansa laitteella.

🌐 Mitä on HTML-vienti ja mitkä ovat sen edut?

Tavalliset Markdown-tiedostot vaativat lukemiseen erityisen katseluohjelman. Jos viet asiakirjasi staattiseksi HTML-verkkosivuksi:

Nolla riippuvuutta: Valmista .html-sivua voidaan kaksoisnapsauttaa ja katsella välittömästi missä tahansa selaimessa puhelimilla, tableteilla tai tietokoneilla ilman lisäosia.
Upotetut kaaviot ja kaavat: Mermaid-kaaviot, Vega-Lite-tietovisualisoinnit ja KaTeX-yhtälöt käännetään sisäisiksi staattisiksi koodeiksi tai SVG-kuviksi ennen vientiä, joten ne renderöityvät täydellisesti myös offline-tilassa.
Valmis isännöitäväksi ja jaettavaksi: Lataa HTML-tiedosto palvelimellesi, GitHub Pages -sivustolle tai Netlifyyn julkaistaksesi tuotedokumentaation, blogit tai käyttöoppaat välittömästi.

🚀 Vaiheet HTML-muunnokseen ja -vientiin

1 Avaa vientipaneeli

Napsauta "Vie" (Export) -painiketta yläpalkin työkalurivin oikeassa reunassa (tai vie hiiri sivupalkin luettelossa olevan muistiinpanojen kohdalle ja napsauta "Vie"-kuvaketta).

2 Valitse HTML-muoto

Klikkaa vientivaihtoehtojen vetolaatikossa "Vie HTML-verkkosivu (.html)" -korttia.

3 Luo ja lataa

Editori alustaa MarkdownToHtml-renderöintimoottorin, lataa GitHub Light -teeman, Prism-syntaksikorostuksen ja KaTeX-resurssit sekä käsittelee Mermaid-kaaviot rinnakkain. Kun prosessi on valmis, selaimesi lataa itsenäisen tiedoston nimeltään [tiedostonimi]_it365.janqi.com__.html.

💡 Vinkkejä ja suunnittelun yksityiskohtia

Viety HTML käyttää oletuksena tyylikästä GitHub Markdown -tyyliä, mikä tarjoaa erinomaisen luettavuuden pitkille asiakirjoille.
Kaaviot upotetaan teräväpiirtoina, häviöttöminä SVG-kuvina HTML-tiedostoon, mikä varmistaa, että ne pysyvät tarkkoina lähennettäessä tai loitonnettaessa.