Изберете фрагмент за публикуване или файл за споделяне
На даден уебсайт или система за съдържание може да е нужен HTML, дори когато предпочитате да пишете в Markdown. Отворете .md файл или поставете съдържанието му, проверете резултата и изберете между фрагмент със съдържание и цялостен HTML документ.
„Копиране на HTML“ връща фрагмент със съдържание. „Изтегляне на HTML“ го обгръща в документ със стилове и вградени шрифтове за формули. Това са различни резултати: фрагментът се нуждае от CSS на целевото място, а изтегленият файл включва оформлението на документа.
Какво съдържа генерираният HTML
Ясна структура
Заглавията, списъците, цитатите, таблиците и връзките стават HTML елементи. Превключете от „Преглед“ към HTML, за да проверите генерирания фрагмент.
Два полезни формата на резултата
Копирайте фрагмент за CMS или изтеглете цялостен HTML документ за преглед и споделяне. Не е нужно да премахвате обвивката на цяла страница, когато целевото място изисква само съдържание.
Технически примери
Често използвани езици за програмиране могат да се оцветяват. Поддържаните формули и диаграми Mermaid се визуализират преди експортиране. Грешките се показват, вместо съдържанието да се подменя без предупреждение.
Оформете самостоятелен документ
Задайте типография и цветове, преди да изтеглите HTML. Визуализираните диаграми се вграждат като SVG, а шрифтовете за формули се включват в изтегления файл.
Започнете с документ, който наистина ви трябва
Раздел от документация
Преобразувайте кратък раздел от статия за съществуваща документация.
## Инсталиране Инсталирайте пакета и **проверете резултата**. ```bash npm ci ``` > Запазете копие на оригиналния Markdown.
- Нивото на заглавието съответства на страницата.
- Командите се четат ясно.
- Цитатът има смислен контекст.
Сравнителна таблица за блог
Запазете табличната информация като истински HTML клетки, а не като екранна снимка.
## Формати за разпространение | Формат | Подходяща следваща стъпка | | --- | --- | | Markdown | Продължете редактирането | | HTML | Публикувайте в уеб | | PDF | Споделете за четене |
- Налични са заглавни клетки.
- Текстът се побира на тесен екран.
- Връзките са проверени.
Практичен работен процес
Поставете Markdown или отворете файл
Използвайте изходния вариант на статията или README файла си. Необработеният HTML извън малкия набор поддържани тагове за форматиране се показва като текст.
Проверете двата изгледа
Прегледайте документа, превключете към HTML и проверете заглавията, връзките и структурата на таблицата. Уверете се, че целевото място приема нужните елементи.
Изберете фрагмент или цял документ
Копирайте HTML в редактор за публикуване, който приема код. Изтеглете HTML, ако ви трябва оформен файл. Преди публикуване изпробвайте резултата в реалната целева среда.
Проверете резултата преди споделяне
| Съдържание | Какво да направите | Какво да очаквате |
|---|---|---|
| HTML фрагмент | Проверете кои HTML елементи и CSS стилове са разрешени в целевата среда. | CMS може да филтрира стилове, SVG или формули, дори ако се виждат в този преглед. |
| Самостоятелен HTML | Отворете изтегления файл отделно. | Стиловете на документа и шрифтовете за формули са включени; разрешените външни изображения все още зависят от своите хостове. |
| Връзки и скриптове | Проверете целевите адреси на връзките. Не използвайте преобразуването за разпространение на скриптове. | Конверторът премахва активното съдържание и показва неподдържания необработен HTML като текст. |
Въпроси за този работен процес
Как да преобразувам Markdown в HTML за уебсайт?
Отворете .md файл или поставете изходния текст и проверете прегледа. Използвайте „Копиране на HTML“ за кода на съдържанието. Изберете „Изтегляне на HTML“, когато ви трябва цялостен документ със стилове. Преди публикуване проверете как сайтът обработва поставен HTML.
Каква е разликата между „Копиране на HTML“ и „Изтегляне на HTML“?
„Копиране на HTML“ дава фрагмент със съдържание. „Изтегляне на HTML“ създава цялостен документ със заглавие, стилове и визуализирано съдържание.
Мога ли да преобразувам Markdown таблици в HTML таблици?
Да. Таблиците с вертикални черти стават HTML елементи за таблици. Сложните обединени клетки не са част от основния Markdown синтаксис и може да изискват ръчна редакция.
Ще се включат ли формулите и Mermaid в HTML?
Поддържаните формули се визуализират с KaTeX, а диаграмите Mermaid се вграждат като SVG. Изтегленият документ включва шрифтове за формулите; копираният фрагмент може да се нуждае от стилове от целевото място.
Мога ли да поставя резултата във всяка CMS система?
Първо проверете правилата на CMS. Някои редактори приемат HTML изходен код, а други показват таговете като текст или премахват SVG и формулите. Изпробвайте малък пример в реалния процес на публикуване.
Работи ли изтегленият HTML изцяло офлайн?
Стиловете на документа, визуализираните диаграми и шрифтовете за формули са включени. Външните изображения и връзки продължават да сочат към първоначалните си адреси, освен ако изображението не е вградено.
Качва ли се Markdown за преобразуването?
Преобразуването от Markdown към HTML и изтеглянето на HTML се извършват в браузъра. Само отделното действие „Изтегляне на PDF“ изпраща визуализирания документ до сайта.
Как инструментът обработва документа ви
- Разчитането на Markdown и генерирането на HTML се извършват локално.
- Копираният HTML е фрагмент; изтегленият HTML е оформен документ.
- Активното съдържание се премахва, но все пак проверете връзките и правилата на CMS системата си.
Справки за форматитеСправочник за HTML елементитеСпецификация на CommonMark
Съобщете за възпроизводим проблемПосочете браузъра, избраните настройки и малък пример без поверителни данни. Не изпращайте лични документи по имейл.
