data include format - speced/respec GitHub Wiki

data-include-format

Applies to: elements with data-include

Specifies the format of the included content.

Usage

<section data-include="changelog.txt"
         data-include-format="text"></section>
<section data-include="intro.md"
         data-include-format="markdown"></section>

Values

Value Behavior
"html" Default. Content is inserted as HTML and processed by ReSpec.
"markdown" Content is converted from GitHub Flavored Markdown to HTML before insertion.
"text" Content is inserted as plain text (escaped, not parsed as HTML).

Notes

  • "html" (default) fully processes the included content — WebIDL, definitions, xrefs all work
  • "markdown" converts Markdown first, then processes the resulting HTML
  • "text" is useful for including raw text like changelogs or ABNF grammars without HTML interpretation
⚠️ **GitHub.com Fallback** ⚠️