Skip to content
Sid Vishnoi edited this page Jun 17, 2020 · 15 revisions

format

Tells ReSpec to treat the document as being in a format other than HTML. Supported formats:

"markdown"
Interpreted as GitHub flavored markdown.

Example

var respecConfig = {
  format: "markdown",
}

Markdown

When format is set to "markdown", you can use a mix of HTML and markdown:

## Using markdown
This will be a paragraph. 

<pre class="example" title="A markdown example">
function thisIsNice(){
  becauseWeCanUseMarkdown();
}

// And using markdown is pretty sweet!
const foo = "FOO";
while(foo){
  Promise.all([...lotsOfPromises])
}
</pre>

Please remember that markdown requires double newlines between an HTML tag and markdown text.

<section>

## Markdown inside HTML tags

This is the correct way to insert markdown inside HTML.

</section>

See also: nolink class to disable automatic linking in code blocks, if needed.

Guides

Configuration options

W3C Configuration options

Linter rules

Internal properties

Handled by ReSpec for you.

Special <section> IDs

HTML elements

Custom Elements

WebIDL

HTML attributes

CSS Classes

Special properties

Clone this wiki locally