<div dir="auto">We also do the testing every night. Since I already have the infrastructure in place I hope to keep using mkdocs with the material look and feel.</div><br><div class="gmail_quote"><div dir="ltr">On Fri, Mar 30, 2018, 9:55 AM David Thompson <<a href="mailto:david.thompson@kitware.com">david.thompson@kitware.com</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">> pandoc is not perfect, but I did use it to convert the book's pdf to<br>
> markdown doc, docx and txt.<br>
<br>
I believe pandoc also deals with restructured text (rst), which is similar to markdown. It is what <a href="https://readthedocs.org/" rel="noreferrer noreferrer" target="_blank">https://readthedocs.org/</a> uses (via the python Sphinx tool). We use it for some other projects at Kitware (SMTK and CMB) and it works well. Unlike markdown, it is extensible (you can write python code to inject HTML/JS/LaTeX etc. into the output).<br>
<br>
It also has some hooks to include portions of external files. We use this to directly include source code (that gets tested!) into the documentation. I am working toward using image tests as part of the documentation. Of course, it's not perfect (there's no guarantee all the documentation makes sense anymore if you change the source). I also want to use it to inject interactive vtk-js content into the online version of the docs (and a screenshot into the offline version), which is possible via an extension if not directly.<br>
<br>
        David</blockquote></div>