Markdown + Pandoc

Источник: Markdown+Pandoc, соединяем миры письменной работы!

Markdown+Pandoc позволяет преобразовать собственные письменные работы в файлы любого существующего формата, включая впечатляющие слайды и HTML5. Никто (или я не видел) не обобщил эту информацию, поэтому мне пришлось пройти через множество трудностей, прежде чем я наконец разобрался в этом вопросе, и я хочу это отметить.

После того как я узнал о Markdown, мой мир письменной работы стал ограничен только им; после того как я увидел возможности преобразования форматов с помощью Pandoc, я очень завидовал создаваемым слайдам и PDF. В то время я представлял себе будущее своей письменной работы следующим образом: сначала я записываю свои идеи с помощью Markdown; затем, используя Pandoc, преобразую готовый файл Markdown в слайд или PDF. Вот и всё.

Pandoc — не знаю, как правильно произносить, Google тоже не нашёл. Ну что ж, буду читать его как «панда», ведь он является национальным достоянием.

Для запуска Pandoc нужно использовать командную строку. Однако это не так просто, и не любая командная строка подойдёт. Вам необходимо скачать Pandoc, см. здесь. Выберите Windows или другую операционную систему в зависимости от ваших потребностей.

После установки запомните каталог Pandoc и перейдите в командную строку для выполнения некоторых устаревших команд doc и преобразования их в пути Pandoc.

Лично я предпочитаю помещать файлы, которые нужно преобразовать, например test.md, в путь Pandoc, чтобы при использовании Pandoc для преобразования не приходилось вводить слишком много путей (особенно учитывая, что многие из наших путей на китайском языке, и могут возникнуть некоторые проблемы). Конечно, вы также можете вызывать файлы из других путей, если вам так удобнее.

Pandoc похож на iconv в Linux и может преобразовывать файлы других форматов в желаемый формат. Для получения подробной информации см. здесь.

Я часто использую два типа преобразования формата:

• a: преобразование файла MD в HTML5

  pandoc -s --mathml -i -t dzslides test.md -o test.html

• b: преобразование файла MD в PDF

  pandoc -t beamer test.md -o test.pdf

Здесь следует подчеркнуть, что для преобразования в файл PDF необходимо установить LATEX. Рекомендуется установить MiKTex. Однако при преобразовании китайского языка в PDF возникают проблемы из-за ограниченной поддержки китайского языка в LATEX. Если вы знакомы с LATEX, вы можете попробовать решить проблему преобразования китайских слайдов в PDF.

Если после преобразования файла есть какие-то проблемы, можно внести изменения в исходный файл MD и выполнить преобразование ещё раз. После практики процесс написания и преобразования становится очень быстрым. Конечно, у Pandoc есть много других возможностей для преобразования, и вы можете исследовать их самостоятельно.

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

Жду ваших комментариев!