Заметка уже размечена заголовками и списками в Markdown, а редактор сайта ждёт HTML. Конвертер ускоряет переход, но получившуюся разметку нужно посмотреть в месте публикации.
Markdown в HTML: подготовьте ссылки
Проверьте исходные адреса и изображения. Относительная ссылка, которая работала в одной папке, может вести не туда на сайте. Затем вставьте документ в Markdown в HTML.
После преобразования
Откройте готовый HTML в подходящем предпросмотре. Проверьте иерархию заголовков, списки, таблицы и ссылки. Если код вставляется внутрь страницы, убедитесь, что он не дублирует уже существующие элементы.
Если нужна обратная версия
Для перевода готового HTML обратно в Markdown есть HTML в Markdown. Если таблица пришла из CSV, сначала подготовьте её в CSV в Markdown. Каждый шаг проверяйте отдельно, чтобы найти источник ошибки.
Пример: заголовок и ссылка в заметке
В исходной заметке есть заголовок «Подготовка» и ссылка на файл. После преобразования заголовок должен стать настоящим элементом заголовка, а адрес ссылки — остаться рабочим. Если в Markdown был относительный путь docs/checklist.pdf, он будет разрешаться относительно адреса опубликованной страницы. Поэтому такая ссылка может сломаться после переноса, даже когда HTML синтаксически верен.
Markdown: ## Подготовка HTML: <h2>Подготовка</h2>
Проверьте адрес в готовой странице нажатием. Для собственного сайта удобнее указать путь от корня, если структура это допускает. Символы < и & внутри обычного текста тоже осмотрите в предпросмотре: они имеют в HTML особый смысл.
Что значит сохранить структуру для поиска и чтения
Заголовок помогает читателю быстро найти раздел и объясняет структуру страницы поисковой системе. Если в исходной заметке несколько строк начинаются с # только потому, что автор хотел крупный шрифт, после преобразования получится несколько главных заголовков. Исправьте уровни в Markdown до конвертации: главный заголовок страницы, затем разделы и подразделы. Изображению дайте осмысленное описание, а ссылке — текст, из которого понятно назначение, вместо «нажмите здесь». Так HTML будет полезен и при чтении с экрана, и при навигации по странице.
После преобразования проверьте ширину таблиц, отступы списков, кодовые блоки и вид ссылок в реальном шаблоне сайта. Если CSS скрывает различие между уровнями заголовков, читателю трудно сканировать текст. Не исправляйте это добавлением случайных жирных строк внутрь статьи: лучше настроить семантические заголовки и стили. На телефоне посмотрите, не появляется ли горизонтальная прокрутка из-за длинного URL или кода.
Итог: HTML готов, когда его ссылки и структура работают в конечном редакторе.
Читайте также: Как вставить небольшую таблицу из CSV в Markdown.
01Почему ссылка после вставки ведёт не туда?
Проверьте исходный относительный адрес и место, куда вставлен HTML.
02Нужно ли просматривать результат?
Да, особенно списки, таблицы и заголовки.
03Изменится ли смысл текста?
Конвертация меняет разметку; содержание всё равно стоит сверить.