Руководство: Конвертация и экспорт Markdown в веб-страницу HTML
Вы можете превратить ваш текущий документ в стильный независимый файл .html для чтения в любое время, в любом месте и на любом устройстве.
🌐 Что такое экспорт в HTML и в чем его преимущества?
Для чтения обычных файлов Markdown нужны специальные программы. Но если вы экспортируете документ в статическую веб-страницу HTML:
- Никаких зависимостей: итоговую страницу
.htmlможно открыть двойным щелчком в любом браузере на телефоне, планшете или компьютере без каких-либо плагинов. - Встроенные формулы и графики: схемы Mermaid, визуализации Vega-Lite и формулы KaTeX компилируются во встроенный статический код или SVG перед экспортом, поэтому они отлично отображаются даже без интернета.
- Готовность к хостингу и отправке: загрузите файл HTML на свой сервер, в GitHub Pages или Netlify, чтобы мгновенно опубликовать документацию к продукту, статьи или инструкции.
🚀 Инструкция по конвертации и экспорту в HTML
1
Откройте панель экспорта
Нажмите кнопку «Экспорт» в правой части верхней панели инструментов (или наведите курсор на заметку в боковом списке и нажмите иконку экспорта).
2
Выберите формат HTML
В открывшейся боковой панели выберите карточку «Экспортировать веб-страницу HTML (.html)».
3
Создание и скачивание
Редактор запустит движок рендеринга
MarkdownToHtml, загрузит тему GitHub Light, подсветку синтаксиса Prism, ресурсы KaTeX и обработает диаграммы Mermaid. После завершения ваш браузер автоматически скачает готовый файл с именем [имя_файла]_it365.janqi.com__.html.
💡 Полезные советы и особенности дизайна
- Экспортируемый HTML по умолчанию использует классический стиль GitHub Markdown, что обеспечивает отличную читаемость длинных документов.
- Диаграммы встраиваются в HTML-файл в виде векторных SVG высокого разрешения. Это гарантирует их четкость при любом масштабировании.