brechtm/rinohtype

Missing HTML content from markdown

olivier-mauras opened this issue · 1 comments

Is there an existing issue for this?

  • I have searched the existing issues

PDF produced by rinohtype

artifact_cards.pdf

I use rinoh as a sphinx builder. All my content is using markdown with the myst-parser plugin.
As you can see, upon generating a PDF from my sphinx content, all HTML code - used for text colors, HTML tables, or other image centering purpose - is absent from the resulting PDF.

What is the best way to include HTML from markdown?

Thanks

Source files

artifact_cards.md

Versions

$ rinoh --versions
rinohtype 0.5.4 (2022-06-17)
Sphinx 5.0.2
Python 3.9.7 (default, Nov 24 2021, 21:15:59) 
[GCC 10.3.1 20211027]
Linux-5.15.43-x86_64-with

Rendering HTML is outside the scope of rinohtype's features.

Note that embedding HTML goes against Sphinx's concept; documentation is written a markup language (reStructuredText, Markdown, ...) to be be rendered to multiple output formats (HTML, PDF, ...).

I would also argue that HTML is too verbose to use as an authoring format. MyST supports table syntax, so maybe you can consider using that instead of HTML tables?

Originally, Markdown was conceived only with HTML output in mind however, so I can see this can be confusing.

Hope this helps!