Есть ли способ преобразовать разметку в Asciidoc (или иметь возможность создавать тот же выход HTML)?

Question

Вот моя проблема, обычно я преобразую документы Asciidoc в HTML (или, точнее, Asciidoc -> Docbook -> HTML), но здесь мне дали документ Markdown.

Я хотел бы иметь возможность создать HTML -документ из этого документа Markdown, который будет выглядеть так же, как если бы он был из Asciidoc, или иметь возможность как -то преобразовать эту отметки в Asciidoc?

Answer 1

Пытаться использовать Пандок Чтобы преобразовать источник разметки в Docbook XML.

Оттуда должно быть возможно преобразовать Docbook XML в HTML с тем же методом, который вы использовали ранее для ввода Asciidoc, например, используйте те же самые XSLT-трансляции для DocBook-> HTML.

Answer 2

Эхом комментария @akosma, Пандок действительно есть Asciidoc поддерживать:

# Convert to AsciiDoc from Markdown:
$ pandoc -t asciidoc -f markdown file1.md > file1.txt

Вы также можете перейти прямо от Markdown до HTML:

$ pandoc -S -t html -f markdown file1.md > file1.html

( -S Просто чтобы создать приятные вьющиеся цитаты и другие умные типографские изменения)

Answer 3

По моему опыту, Pandoc не конвертирует много документов правильно, поэтому я создал свой собственный конвертер, который можно найти здесь.

Это простой инструмент, написанный на Java, который был успешно использован для преобразования многих документов, включая руководство от Геб.

Answer 4

Я брошу еще один в микс. Я написал пользовательский преобразователь для Kramdown, который преобразует Markdown в Asciidoc.

https://github.com/opendevise/kramdown-asciidoc

Преимущество этой библиотеки заключается в том, что Kramdown чрезвычайно хорош в анализе Markdown со вкусом GitHub, что, вероятно, является наиболее заинтересованной, из которой люди напоминают.