MarkdownToAsciidoc

Test project for markdown to asciidoc conversion.

マークダウンをAsciidocに変換するにはPandocではなくDocker-AsciidoctorにあるKramdocを使うと良いということを示す。

Kramdocについてはsee Here.

Sample markdown

Downloaded from https://www.dropbox.com/s/4z6kot27jmikhx5/forapp-markdown-sample.md.

エラーを起こしそうな部分や冗長な箇所は取り除いた。

Pandoc Command

--to asciidoctorが肝要だと思われる。なお，v1.9.11では動かなかった。

pandoc sample.md --to asciidoctor -o sample_pandoc.adoc --shift-heading-level-by=-1

Docker-Asciidoctor Command

wsl docker run --rm -v $(pwd):/documents/ asciidoctor/docker-asciidoctor kramdoc  --wrap=ventilate --format=GFM sample.md

adoc to html command

option
- left toc
- data-uri
- asciidoctor-diagram

wsl docker run --rm -v $(pwd):/documents/ asciidoctor/docker-asciidoctor asciidoctor <sample.adoc> -r asciidoctor-diagram -a allow-uri-read -a data-uri -a toc=left

Known Problems

試して判明したエラーや知見など。

PHPのシンタックスハイライトをつけようとするとエラーが出る

xmlのコメントを変換する機能でエラーがでる。以下がそのエラー文。

/usr/lib/ruby/gems/2.7.0/gems/kramdown-asciidoc-1.0.1/lib/kramdown-asciidoc/converter.rb:99:in `convert': undefined method `convert_xml_pi' for #<Kramdown::AsciiDoc::Converter:0x0000561a13adec28> (NoMethodError)
Did you mean?  convert_li

デバッグの結果以下が原因となった部分。

<?php if (is_tag()){ $posts = query_posts($query_string . '&showposts=20'); } ?>

バージョンによっては改善しているかもしれない。

リンク以降の改行がおかしい

定義参照リンク以降の変換がバグる。
- 定義参照リンクは別口で書くなどして対応するしか？

niszet/MarkdownToAsciidoc