Основы Pandoc
Pandocopen in new window конвертирует текстовые файлы из одних форматов в другие. Рассмотрим его базовые команды.
Все примеры расположены в репозиторииopen in new window.
Конвертация
Pandoc является обычным консольным приложением и принимает команды стандартным образом.
По умолчанию Pandoc принимает данные для конвертации из входного потока и отправляет во выходной поток. Чтобы определить исходный файл передайте ему имя файла:
pandoc input01.md
Чтобы указать вывод в файл используйте параметр -o:
pandoc -o output.html input01.md
На вход можно передать несколько файлов, в этом случае Pandoc их объединит в один:
pandoc -o output.html input01.md input02.md
Части документов
По умолчанию, Pandoc выводит только преобразованные в целевой формат фрагменты. Если нужно получить целый файл, то укажите параметр -s/--standalone .
pandoc -o output.html -f markdown -t html -s input01.md input02.md
Для формата HTML полноценный документ будет включать в себя все обязательные для документа теги head, body и остальные, а если конвертировать фрагменты то в выходном файле будут только отдельные абзацы.
Форматы файлов
В предыдущих примерах Pandoc автоматически определял формат файла по расширению. Команды -f/--from и -t/--to указывают формат в явном виде:
pandoc -o output.txt -f markdown -t dokuwiki input01.md input02.md
Списки поддерживаемых входных и выходных форматов выводятся командами:
pandoc --list-input-formats
pandoc --list-output-formats
Кодировка
Pandoc использует кодировку utf-8 для выходных и выходных файлов.