# 实体和数字字符引用

可以使用有效的 HTML 实体引用和数字字符引用来代替相应的 Unicode 字符，但以下情况除外：

• 在代码块和行内代码中无法识别实体和字符引用。

• 实体和字符引用不能代替在 CommonMark 中定义结构元素的特殊字符。 例如，虽然 * 可用于代替字面量的 * 字符，* 不能替代 在强调分隔符，无序列表标记或专门的换行中的 *。

符合 CommonMark 的解析器无需使用 Unicode 字符或实体引用，来存储有关特定字符是否在源中表示的信息。

实体引用包含 & + 任何有效的HTML5实体名 + ;。文档https://html.spec.whatwg.org/multipage/entities.json是一个有效实体引用和相应代码的权威来源。

  & © Æ Ď
¾ ℋ ⅆ
∲ ≧̸

<p>  &amp; © Æ Ď
¾ ℋ ⅆ
∲ ≧̸</p>

十进制字符由&#+ 包含 1-7 个阿拉伯数字的字符串 + ; 组成，数字字符引用被解析为相应的 Unicode 字符。 无效的 Unicode 代码点将替换为 REPLACEMENT CHARACTER（U+FFFD）。 出于安全原因，代码点U+0000也将被U+FFFD替换。

# Ӓ Ϡ �

<p># Ӓ Ϡ �</p>

十六进制字符由 &# + X 或 x + 1-6 个十六进制数字 + ; 组成，它们也被解析为相应的 Unicode 字符（这次使用十六进制数字而不是十进制数字）。

" ആ ಫ

<p>&quot; ആ ಫ</p>

以下是一些非实体引用：

&nbsp &x; &#; &#x;
�
&#abcdef0;
&ThisIsNotDefined; &hi?;

<p>&amp;nbsp &amp;x; &amp;#; &amp;#x;
&amp;#87654321;
&amp;#abcdef0;
&amp;ThisIsNotDefined; &amp;hi?;</p>

尽管 HTML5 中使用了一些没有尾随分号的实体引用（例如&copy），在这里没有识别，因为这会混淆语法。

&copy

<p>&amp;copy</p>

不在 HTML5 命名实体列表中的字符串也不会被识别为实体引用：

&MadeUpEntity;

<p>&amp;MadeUpEntity;</p>

除了行内代码或代码块（包括 URL，链接标题，围栏代码块和信息字符串）之外，实体和数字字符引用可以在任何上下文中被识别：

<a href="&ouml;&ouml;.html">

<a href="&ouml;&ouml;.html">

[foo](/föö "föö")

<p><a href="/f%C3%B6%C3%B6" title="föö">foo</a></p>

[foo]

[foo]: /föö "föö"

<p><a href="/f%C3%B6%C3%B6" title="föö">foo</a></p>

``` föö
foo
```

<pre><code class="language-föö">foo
</code></pre>

实体和数字字符引用在行内代码和代码块中被视为文字文本：

`föö`

<p><code>f&amp;ouml;&amp;ouml;</code></p>

    föfö

<pre><code>f&amp;ouml;f&amp;ouml;
</code></pre>

实体和数字字符引用不能用于代替表示 CommonMark 文档中结构的符号。

*foo*
*foo*

<p>*foo*
<em>foo</em></p>

* foo

* foo

<p>* foo</p>
<ul>
<li>foo</li>
</ul>

foo

bar

<p>foo

bar</p>

	foo

<p>→foo</p>

[a](url "tit")

<p>[a](url &quot;tit&quot;)</p>