Adding html to markdown files

[badlydrawnrob]

Sketch out the pros and cons, as well as the workflow options

Markdown is a simple formatting method, so it's probably best not to get too clever when writing and formatting ... but when adding HTML, current difficulties:

Pandoc allows the following syntax to wrap with a div:

::: {#special}
text goes here
:::

• Marked App seems to add empty paragraphs, causing broken layout
• Pandoc doesn't seem to suffer from this problem

Code example:

<div class="split"><div class="split-left">

- list
- of
-stuff

</div><div class="split-right">

Content

</div></div>

Need to decide whether it's best to:

1. Use Markdown for full pages (with HTML inside file)
2. Use Markdown for partials (and a templating language)
3. Use Markdown with frontmatter
4. Use javascript to style some elements (the introduction, for instance)

HTML inside Markdown is easy(ish) to compile, and if done right can provide some flexibility (such as figcaption etc) — but feels a bit hacky, somehow.

Perhaps there's a balance between building a structure and using markdown files, within that structure.