Markdown 元素样张

本文展示Lumira主题中可能出现的所有元素样例

二级标题：段落与强调

普通段落。粗体、斜体、粗斜体、删除线，以及 行内代码。行内代码的三种典型排法：小写标识符 lumira_option、中英文混排 BUAA博士在读、操作符 &&；紧贴中文是 这样，被标点夹住是（这样）。

链接：Typecho、自动链接 https://typecho.org，以及裸露的 https://typecho.org 。

图片与图注：

三级标题：列表

无序列表：

• 第一项
• 第二项，带 行内代码

• 第三项

  • 嵌套一项
  • 嵌套二项

有序列表：

1. 第一步
2. 第二步
3. 第三步

四级标题：引用

引用第一行。
引用第二行，带 粗体。

嵌套引用。

五级标题：代码

带语言的围栏代码块：

$hue = lumira_option('accent_hue');if ($hue === null) {    echo '缺键的时候回落到默认值';}

不带语言的围栏代码块：

一段没有语言的代码第二行

缩进四个空格产生的代码块：

indented code line oneindented code line two

六级标题：表格

表格里也能放 行内代码 与 粗体。

脚注与数学

带脚注的一句话¹。

行内数学 $a^2 + b^2 = c^2$，块级写法下面这几种。

单独一段公式：

$$ \int_0^1 x^2 \mathrm{d}x = \frac{1}{3} $$

会自己编号的环境（align、gather、equation 三种）：

$$ \begin{align} a^2 + b^2 &= c^2 \\ e^{i\pi} + 1 &= 0 \end{align} $$

分段函数与矩阵：

$$ \begin{cases} x, & x > 0 \\ 0, & x \le 0 \end{cases} \qquad \begin{pmatrix} a & b \\ c & d \end{pmatrix} $$

手写编号：

$$ F = ma \tag{1} $$

手写方括号定界符，反斜杠要写两个（Markdown 会把单个反斜杠当转义吃掉）：

\[
\sum_{k=1}^{n} k = \frac{n(n+1)}{2}
\]

围栏 math 块：

\begin{aligned}
\nabla \cdot \mathbf{E} &= \frac{\rho}{\varepsilon_0} \\
\nabla \cdot \mathbf{B} &= 0
\end{aligned}

KaTeX 不支持 eqnarray，也不支持 \label 与 \ref 交叉引用：写进去会原样显示成一行不对的公式，不会白屏。如需编号请用 align、gather、equation，或者手写 \tag{…}。

行内 HTML

内核只放行一份白名单：kbd、b、i、strong、em、sup、sub、br、code、del、a、hr、small。

Ctrl+S、_下标、^上标、手写的删除线、小字。

白名单之外的标签会被转义成文本，<mark> 就是这样，这是内核行为，不是主题的缺陷。

块级 HTML 也照排：

短代码

短代码写在正文里，保存的时候由主题渲染成零件。下面每条先给一个例子，再给使用方法。代码块里的短代码不会被解析。

提示框

{tip}默认的提示框，不写属性就是它。{/tip}{tip type="warning" title="注意"}带标题的警告框。{/tip}{tip type="danger" title="危险"}出错一类的提示。{/tip}{tip type="success" title="完成"}做完了一件事。{/tip}

折叠框

{collapse title="点开看详情"}折叠起来的内容，默认是收起的。{/collapse}{collapse title="这一段默认就是打开的" show="true"}……{/collapse}

按钮

红色 绿色 蓝色 紫色 黄色描边 灰色描边

{button url="地址" type="red"}文字{/button}

六个颜色有两种不同的格式：红、绿、蓝、紫是实心，黄与灰是描边；不写 type 也是实心。链接地址只放行 http 与 https，别的内容则会让它退化成一行普通文字。

点击复制

点一下复制这条命令

{copy text="被复制的内容"}按钮上的字{/copy}

不写 text 时，复制的是标签里那段文字。

下载链接

Typecho 安装包

{file url="地址"}文件名{/file}

标签卡

{tabs selected="2"}{tab name="第一页"}第一页的内容。{/tab}{tab name="第二页"}第二页的内容。{/tab}{/tabs}

相册

{photo title="相册标题" set="3"}![](图片地址){/photo}

set 是列数，写 "2,4" 这类多段值时，窄屏按第一个数字排布、宽屏按第二个数字排布。

网格布局

{grid set="2"}{card}第一格{/card}{card}第二格{/card}{/grid}

时间线

{timeline}{p}**日期** 事情{/p}{/timeline}

链接卡片

{link}{站名,一句话描述,https://地址}{站名,一句话描述,https://地址,https://图标地址}{/link}

一行一个，四段之间用英文逗号隔开，图标那一段可以不写。

引用另一篇文章

cid换成要引用的那篇文章的编号。文章不存在或者已经被删掉时，这里则会出现一行中文提示。

居中与居右

{center}这一行居中。{/center}{right}这一行居右。{/right}

文字颜色与下划线

红色、绿色、蓝色、黄色、紫色，另有 单下划线、双下划线、删除线。

{red}红色{/red}  绿色是 {green}…{/green}，蓝、黄、紫同理+-单下划线+-    -+双下划线-+    ~~删除线~~

登录可见

{login}只给登录的访客看的内容{/login}

Mermaid 图表

graph LR
  A[浏览器] --> B[nginx]
  B --> C[Typecho 内核]
  C --> D[主题模板]