HTML

Standard Markdown parsers seamlessly allow mixing Markdown and HTML content, mainly because they solely rely on HTML rendering and it's easy to make HTML content slip and be rendered as-is.

**Hello** <em>world</em>!

On the other hand, Quarkdown strongly enforces target agnosticism, since the same source must be rendered similarly across all supported rendering target.

At this time, only HTML rendering is supported (note: PDF export is not a rendering target, as it works on top of HTML post-processing). There are however future plans to bring more targets in, such as LaTeX. In that case, HTML content can be no longer handled by the native target anymore.

For this reason, it was decided to remove HTML blocks from Quarkdown, with the effort of providing functions for all use-cases that are usually work-arounded in standard Markdown via HTML.

• A collapsible block in standard Markdown via HTML:

  <details>
  <summary>Title of the collapsible block</summary>
  Content of the collapsible block.
  </details>

• The same in Quarkdown, using the .collapse function:

  .collapse {Title of the collapsible block}
    Content of the collapsible block.
  

Forcing HTML injection

As a last resort, if the functionality you're looking for is not supported out of the box, you might consider calling the .html function, which directly renders its content into the final document, as long as the rendering target is HTML.

**Hello** .html {<em>world</em>}!

.html
  <div class="my-container">
    My HTML container
  </div>

Warning

.html renders the unsanitized content as-is without any further processing. It might be weak and unsafe, thus it's best to use it only when strictly needed.