brechtm / rinohtype

The Python document processor
http://www.mos6581.org/rinohtype
GNU Affero General Public License v3.0
499 stars 59 forks source link

Missing HTML content from markdown #341

Closed olivier-mauras closed 2 years ago

olivier-mauras commented 2 years ago

Is there an existing issue for this?

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
brechtm commented 2 years ago

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!