Using HTML in Markdown

Markdown is designed to be converted into HTML, but it's not a complete replacement for it. If you find that Markdown's syntax isn't enough for what you need, you can always fall back to raw HTML.

How it Works

Most Markdown processors allow you to insert HTML tags directly into your text. When the file is processed, any HTML tag you've included will be passed through to the final output as is.

Block-Level vs Inline HTML

You can use both block-level (like div, table) and inline (like span, kbd) tags.

Inline HTML

Inline tags can be used anywhere within a Markdown paragraph.

Block-Level HTML

Block-level HTML tags should be separated from surrounding content by blank lines, and the start and end tags should not be indented with tabs or spaces.

When to use HTML?

Complex Tables: If you need merged cells or complex layouts that Markdown tables can't handle.
Styling: When you need specific colors, fonts, or layouts using CSS classes or inline styles.
Missing Features: For elements that don't have a Markdown equivalent, like the details and summary tags.