缩写扩展 (Markdig 规范文档)
本节描述了支持的不同扩展:
缩写
缩写可以通过使用 *[缩写标签]: 缩写描述
来声明。
缩写定义将从原始文档中移除。任何在字面量中找到的缩写标签将被替换为缩写描述:
*[HTML]: Hypertext Markup Language
Later in a text we are using HTML and it becomes an abbr tag HTML
.
<p>Later in a text we are using <abbr title="Hypertext Markup Language">HTML</abbr> and it becomes an abbr tag <abbr title="Hypertext Markup Language">HTML</abbr></p>
缩写定义可以最多缩进 3 个空格:
*[HTML]: Hypertext Markup Language
*[This]: is not an abbreviation
.
<pre><code>*[This]: is not an abbreviation
</code></pre>
缩写可以包含空格:
*[SUPER HTML]: Super Hypertext Markup Language
This is a SUPER HTML document
.
<p>This is a <abbr title="Super Hypertext Markup Language">SUPER HTML</abbr> document</p>
缩写可以包含任何 Unicode 字符:
*[😃 HTML]: Hypertext Markup Language
This is a 😃 HTML document
.
<p>This is a <abbr title="Hypertext Markup Language">😃 HTML</abbr> document</p>
相似的缩写是允许的:
*[1A]: First
*[1A1]: Second
*[1A2]: Third
We can abbreviate 1A, 1A1 and 1A2!
.
<p>We can abbreviate <abbr title="First">1A</abbr>, <abbr title="Second">1A1</abbr> and <abbr title="Third">1A2</abbr>!</p>
缩写应匹配整个单词:
*[1A]: First
We should not abbreviate 1.1A or 11A!
.
<p>We should not abbreviate 1.1A or 11A!</p>
即使单词是整个内容,缩写也应匹配整个单词:
*[1A]: First
1.1A
.
<p>1.1A</p>
即使存在另一个术语表项,缩写也应匹配整个单词:
*[SCO]: First
*[SCOM]: Second
SCOM
.
<p><abbr title="Second">SCOM</abbr></p>
缩写应仅在周围有空白时匹配:
*[PR]: Pull Request
PRAA
.
<p>PRAA</p>
单字符缩写应该被匹配:
*[A]: Foo
A
.
<p><abbr title="Foo">A</abbr></p>
应使用最长匹配的缩写:
*[Foo]: foo
*[Foo Bar]: foobar
Foo B
.
<p><abbr title="foo">Foo</abbr> B</p>