Przewodnik: Konwersja i eksport Markdown do strony HTML
Możesz przekształcić aktywną notatkę w estetyczny, niezależny plik .html, który otworzysz bez problemu na każdym telefonie lub komputerze.
🌐 Co to jest eksport do HTML i jakie ma zalety?
Klasyczne pliki Markdown wymagają specjalnych czytników. Udostępnienie dokumentu w formie statycznej strony HTML rozwiązuje te problemy:
- Brak zależności: Plik
.htmlotworzysz bezpośrednio w dowolnej przeglądarce na telefonie, tablecie lub komputerze – bez żadnych wtyczek. - Osadzone wykresy i wzory: Wykresy Mermaid, wizualizacje Vega-Lite oraz wzory matematyczne KaTeX są przed eksportem kompilowane do statycznego kodu lub wektorów SVG, dzięki czemu wyświetlają się poprawnie również offline.
- Gotowość do publikacji online: Możesz przesłać plik HTML na swój serwer, GitHub Pages lub Netlify, by natychmiast opublikować dokumentację, wpis na blogu czy instrukcję.
🚀 Instrukcja eksportu do pliku HTML
1
Otwórz panel eksportu
Kliknij przycisk „Eksportuj” z prawej strony górnego paska narzędzi (lub najedź kursorem na dokument na liście bocznej i kliknij ikonę eksportu).
2
Wybierz format HTML
W wysuniętym panelu opcji eksportu kliknij kartę „Eksportuj stronę HTML (.html)”.
3
Generowanie i pobieranie
Edytor uruchomi silnik renderujący
MarkdownToHtml, załaduje motyw GitHub Light, kolorowanie kodu Prism, zasoby KaTeX oraz przetworzy diagramy Mermaid. Po ukończeniu przeglądarka rozpocznie pobieranie pliku o nazwie [nazwa pliku]_it365.janqi.com__.html.
💡 Wskazówki i szczegóły projektu
- Wyeksportowany plik HTML stosuje domyślnie przejrzysty styl GitHub Markdown, który gwarantuje doskonałą czytelność długich artykułów.
- Schematy są zapisywane wewnątrz pliku HTML jako grafika wektorowa SVG w wysokiej rozdzielczości, dzięki czemu nie tracą na ostrości przy powiększaniu.