On this page
- raw-html
- setext-heading
- indented-code
- tilde-fence
- rule-marker
- trailing-heading-attributes
- directive
- element-name
- multiline-attributes
- lazy-line
- reference-link
- footnote
- bare-url
- relative-autolink
- named-reference
- trailing-spaces
- underscore-strong
- star-emphasis
- single-tilde
- inline-attributes
- math-delimiter
- jsx
- toml-metadata
Not supported
Each form docs/syntax.md cuts, under its warning code. The text stays, and every warning an example raises has that code.
raw-html
<div>
hi
</div>
.
<p><div>
hi
</div></p>
.
<div>
</div>
a <b>c</b> and <!-- x -->
.
<p>a <b>c</b> and <!-- x --></p>
.
<b>
</b>
<!-- x -->
</about>
.
<p></about></p>
.
</about>
<!--> and <!---> are whole comments, as in CommonMark, so they are raw HTML too.
<!-->b and a <!---> c
.
<p><!-->b and a <!---> c</p>
.
<!-->
<!--->
setext-heading
Title
===
.
<p>Title
===</p>
.
===
Title
---
.
<p>Title
---</p>
.
---
indented-code
code
.
<p>code</p>
.
code
para
more
.
<p>para</p>
<p>more</p>
.
more
tilde-fence
~~~
x
~~~
.
<p>~~~
x
~~~</p>
.
~~~
~~~
rule-marker
___
* * *
.
<p>___</p>
<p>* * *</p>
.
___
* * *
trailing-heading-attributes
## Title {#id}
.
<h2 id="title-id">Title {#id}</h2>
.
{#id}
directive
remark-directive's colon forms stay text, all of each, so the […]{…} in one is never a span.
:::note
Body
:::
.
<p>:::note
Body
:::</p>
.
:::note
:::
::chart-view{type=bar} and :kbd[Ctrl] and H:sub[2]O
.
<p>::chart-view{type=bar} and :kbd[Ctrl] and H:sub[2]O</p>
.
::chart-view{type=bar}
:kbd[Ctrl]
:sub[2]
:span[x]{.y}
.
<p>:span[x]{.y}</p>
.
:span[x]{.y}
element-name
A name that isn't an element leaves the whole element as text, nothing in it read as other syntax.
[Sales]{@chart type=bar /}
.
<p>[Sales]{@chart type=bar /}</p>
.
[Sales]{@chart type=bar /}
For a container, only the opening and closing lines are text; the body is still Markdown.
{@note}
- a _b_
{/note}
.
<p>{@note}</p>
<ul>
<li>a <em>b</em></li>
</ul>
<p>{/note}</p>
.
{@note}
{/note}
A [**x**]{@note .y} here
.
<p>A [**x**]{@note .y} here</p>
.
[**x**]{@note .y}
Elements Markdown already writes, and anything that could run code, aren't names.
[x]{@em} and [x]{@script}
.
<p>[x]{@em} and [x]{@script}</p>
.
[x]{@em}
[x]{@script}
Inline and block elements don't mix.
[x]{@div} and
[y]{@span /}
.
<p>[x]{@div} and</p>
<p>[y]{@span /}</p>
.
[x]{@div}
[y]{@span /}
multiline-attributes
{.a
.b}
# x
.
<p>{.a
.b}</p>
<h1 id="x">x</h1>
.
{.a⏎.b}
lazy-line
> a
b
.
<blockquote>
<p>a</p>
</blockquote>
<p>b</p>
.
b
- a
b
.
<ul>
<li>a</li>
</ul>
<p>b</p>
.
b
> a
```b`c
.
<blockquote>
<p>a</p>
</blockquote>
<p>```b`c</p>
.
```b`c
reference-link
[x][y] and [z][]
.
<p>[x][y] and [z][]</p>
.
[x][y]
[z][]
[y]: /url
.
<p>[y]: /url</p>
.
[y]:
footnote
a claim[^1].
.
<p>a claim[^1].</p>
.
[^1]
[^1]: the note
.
<p>[^1]: the note</p>
.
[^1]:
Wow![^1]
[^1]: a note that interrupts the paragraph
.
<p>Wow![^1]
[^1]: a note that interrupts the paragraph</p>
.
[^1]
[^1]
bare-url
see https://a.com/x_(y). ok
.
<p>see https://a.com/x_(y). ok</p>
.
https://a.com/x_(y)
or www.a.com, and http://b.io
.
<p>or www.a.com, and http://b.io</p>
.
www.a.com
http://b.io
mail me@example.com.
.
<p>mail me@example.com.</p>
.
me@example.com
_at https://a.com_
.
<p><em>at https://a.com</em></p>
.
https://a.com
WWW.A.COM and 0https://b.io
.
<p>WWW.A.COM and 0https://b.io</p>
.
WWW.A.COM
https://b.io
at www._ it stops
.
<p>at www._ it stops</p>
.
www.
relative-autolink
go </docs/intro>
.
<p>go </docs/intro></p>
.
</docs/intro>
named-reference
© &
.
<p>&copy; &amp; &nbsp;</p>
.
©
&
In an attribute value too, the reference stays as written.
[x]{@abbr title="a'b"}
.
<p><abbr title="a&apos;b">x</abbr></p>
.
'
trailing-spaces
a␣␣
b
.
<p>a
b</p>
.
␣␣
a→␣␣
b
.
<p>a
b</p>
.
␣␣
underscore-strong
__b__
.
<p>__b__</p>
.
__b__
star-emphasis
*a* and *b*
.
<p>*a* and *b*</p>
.
*a*
*b*
single-tilde
~a~
.
<p>~a~</p>
.
~a~
inline-attributes
word{.x}
.
<p>word{.x}</p>
.
{.x}
`c`{.x} _e_{#y}
.
<p><code>c</code>{.x} <em>e</em>{#y}</p>
.
{.x}
{#y}
x[1]{.a}{.b}
.
<p>x<span class="a">1</span>{.b}</p>
.
{.b}
math-delimiter
The energy is $$E = mc^2$$ here.
.
<p>The energy is $$E = mc^2$$ here.</p>
.
$$E = mc^2$$
the $`x^2`$ form
.
<p>the $`x^2`$ form</p>
.
$`x^2`$
jsx
<Chart data="x" /> and </Chart>
.
<p><Chart data="x" /> and </Chart></p>
.
<Chart data="x" />
</Chart>
toml-metadata
+++
title = "x"
+++
# t
.
<p>+++
title = "x"
+++</p>
<h1 id="t">t</h1>
.
+++⏎title = "x"⏎+++