HTML

Markdown covers most needs, but sometimes HTML does the job better. You can write HTML directly in your pages:

<details>
  <summary>Show the full configuration</summary>

  Everything in here is hidden until the reader opens it.
</details>

Other useful elements:

#What Clay removes

Docs are often written by many people, including outside contributors. To keep a page from harming its readers, Clay cleans the HTML of every page with DOMPurify when it builds the site. It removes:

• <script> elements and event handlers like onclick or onerror,
• javascript: links,
• forms and their fields (<form>, <input>, <textarea>, <select>), which could be used for phishing,
• <style> elements and style attributes, which could lay content over the page.

Everything else, including tables, images, <details> and inline formatting, stays as you wrote it.

<p onclick="steal()">Text</p>   <!-- becomes <p>Text</p> -->
<script>alert(1)</script>       <!-- removed -->