<div dir="auto">Mkdocs does contain admonitions. Also I process the markdown and create the cross references automatically.</div><br><div class="gmail_quote"><div dir="ltr">On Fri, Mar 30, 2018, 9:08 AM Matthew Brett <<a href="mailto:matthew.brett@gmail.com">matthew.brett@gmail.com</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Hi,<br>
<br>
On Fri, Mar 30, 2018 at 4:26 PM, Andras Lasso <<a href="mailto:lasso@queensu.ca" target="_blank" rel="noreferrer">lasso@queensu.ca</a>> wrote:<br>
> Despite all its limitations, Markdown is becoming one of the most widely<br>
> used standard in technical writing. You can get books authored in Markdown<br>
> published as hardcopy, see for example<br>
> <a href="http://docs.atlas.oreilly.com/writing_in_markdown.html" rel="noreferrer noreferrer" target="_blank">http://docs.atlas.oreilly.com/writing_in_markdown.html</a>.<br>
><br>
><br>
><br>
> If we can live without sophisticated typesetting then we could save a lot of<br>
> time and be “compatible” with many more potential authors and online<br>
> publishing services by using Markdown instead of Latex.<br>
<br>
You probably saw the warning on the O'Reilly Markdown page:<br>
<br>
"""<br>
Markdown is best for simple content. It does not support many standard<br>
technical book elements, including parts, admonitions, sidebars, and<br>
cross references.<br>
"""<br>
<br>
Some of that might be called "typsetting" but maybe not parts or<br>
cross-references.<br>
<br>
Matthew<br>
</blockquote></div>