Найти в Дзене
Заметки IT-инженера

Как сделать документ из Markdown файла?

Ситуация: у Вас есть инструкция в README.md и ее срочно нужно превратить в документ, который можно было бы передать коллегам для ознакомления. Ридми достаточно объемный, разделен на части и имеет оглавление. Все это должно работать в экспортируемом документе. Как это сделать? Возможно есть масса эффективных способов. Поэтому вот еще один, который был успешно опробован на личном опыте:

Как сделать документ из Markdown файла?

Ситуация: у Вас есть инструкция в README.md и ее срочно нужно превратить в документ, который можно было бы передать коллегам для ознакомления. Ридми достаточно объемный, разделен на части и имеет оглавление. Все это должно работать в экспортируемом документе. Как это сделать?

Возможно есть масса эффективных способов. Поэтому вот еще один, который был успешно опробован на личном опыте:

  1. Необходимо сконвертироать README.md в HTML-файл. Это позволит сохранить навигацию внутри документа. Подойдет любой софт, который решает данную задачу. Например - markdowntohtml
  2. Если в документе есть картинки, то необходимо заменить src в них с ссылок на base64 embeded, чтобы картинка оказалась внутри полученного HTML-файла. Можно воспользоваться готовой утилитой для конвертации Вашей фотографии в Base64