Inline Html
Inline Html

Compatibility notes for HTML tags in IOModel Markdown.

Inline HTML is currently restricted in IOModel Markdown rendering.

Current behavior

By renderer implementation, most HTML tags are ignored in output.

Use <kbd>Cmd</kbd> + <kbd>K</kbd> to open quick search.

<details>
  <summary>Expand troubleshooting notes</summary>
  Retry with a fresh token if authentication fails.
</details>

What is rendered

  • Tags like <kbd>, <details>, <summary>, <div>, <span>, etc. are ignored.
  • Special-case: <img ...> is supported and rendered via the image pipeline.

Security and compatibility

  • Inline HTML should be treated as unsupported unless explicitly documented.
  • Prefer Markdown syntax and MDX components instead of raw HTML tags.
  • For images, prefer Markdown image syntax ![alt](path) (or <img> only when necessary).

Guidance

Prefer MDX components and Markdown-native constructs:

  • Callout instead of custom <div> notice blocks
  • Tabs / Steps instead of custom HTML layout wrappers
  • Markdown links/lists/tables instead of handcrafted HTML equivalents

Last updated on