Основы Pandoc | Way23

Основы Pandoc

Pandocopen in new window конвертирует текстовые файлы из одних форматов в другие. Рассмотрим его базовые команды.

Все примеры расположены в репозиторииopen in new window.

Конвертация

Pandoc является обычным консольным приложением и принимает команды стандартным образом.

По умолчанию Pandoc принимает данные для конвертации из входного потока и отправляет во выходной поток. Чтобы определить исходный файл передайте ему имя файла:

pandoc input01.md
1

Чтобы указать вывод в файл используйте параметр -o:

pandoc -o output.html input01.md
1

На вход можно передать несколько файлов, в этом случае Pandoc их объединит в один:

pandoc -o output.html input01.md input02.md
1

Части документов

По умолчанию, Pandoc выводит только преобразованные в целевой формат фрагменты. Если нужно получить целый файл, то укажите параметр -s/--standalone .

pandoc -o output.html -f markdown -t html -s input01.md input02.md
1

Для формата HTML полноценный документ будет включать в себя все обязательные для документа теги head, body и остальные, а если конвертировать фрагменты то в выходном файле будут только отдельные абзацы.

Форматы файлов

В предыдущих примерах Pandoc автоматически определял формат файла по расширению. Команды -f/--from и -t/--to указывают формат в явном виде:

pandoc -o output.txt -f markdown -t dokuwiki input01.md input02.md
1

Списки поддерживаемых входных и выходных форматов выводятся командами:

pandoc --list-input-formats
1
pandoc --list-output-formats
1

Кодировка

Pandoc использует кодировку utf-8 для выходных и выходных файлов.

Ссылки

Последниее изменение: 31.08.2021, 15:52:51