Конвертация markdown в html

Собственно, формат markdown очень удобен для создания всяких "быстрых" документов, типа manual, help, faq и т.п.

И существует очень удобный конвертер-преобразователь разных текстовых форматов практически во всё: pandoc

Далее, имеем каталог, в котором собраны наши .md файлы пачками со ссылками друг на друга, типа "default.md":

% test-test

# TEST

** hello **

[go to test](./test.md)

Конвертация происходит по каждому файлу отдельно в цикле, примерно так:

pandoc -f markdown -t html5 ./md/default.md -o ./html/default.html --lua-filter=links-to-html.lua

где фильтр помогает нам преобразовать расширения .md в .html:

# links-to-html.lua
function Link(el)
  el.target = string.gsub(el.target, "%.md", ".html")
  return el
end

Свой шаблон html также можно указать в параметре --template:

pandoc -f markdown -t html5 ./md/default.md -o ./html/default.html --lua-filter=x.lua --template=page.html5

а получить "начальный" шаблон для последующей коррекции легко таким образом:

pandoc -D html5 > page.html5


#