写作模板
博客写作规范与语法参考
所有支持的语法、shortcode 与 HTML 元素一览
12Shortcode
8HTML 组件
6链接语法
5自定义元素
章节标签
章节标题
时间范围
正文段落。使用 加粗、斜体、行内代码。
这是一段包含 高亮文字 的正文。
织田信长(Oda Nobunaga)— 战国三杰之一
提示:提示框内容。
信息框标题
信息框内容。标题不加入 TOC。
定义框
放定义、符号、直觉解释。
定理框
放命题、定理、推论和判定条件。
例题框
题目:示例题目。 答案:示例答案。易错点:示例提醒。
复习速查
- 定义:一行回忆核心概念。
- 公式:列最重要的结论。
引用内容。
— 来源
| 表头1 | 表头2 | 表头3 |
|---|---|---|
| 单元格 | 单元格 | 单元格 |
- 第一项
- 第二项
- 列表项
- 术语一
- 这是定义说明
- 带强调的术语
- 定义内容
def hello():
print("Hello, World!")
公式渲染
LaTeX 数学公式
行内公式 $O(T\epsilon^2)$ 或 \(x\in\mathbb{R}^{d}\),必须嵌入普通正文段落中。
$$\Theta \Bigl(\frac{K^4 d^5 B^6}{\epsilon^2}\Bigr)$$
也可以使用 display math:
$$\mathcal{L}(\theta)=\mathbb{E}_{x\sim p_{\text{data}}}\bigl[-\log p_\theta(x)\bigr]$$
引用标注
参考文献引用
根据 #Hinton et al., 2015 的开创性工作,知识蒸馏用软标签把教师模型的暗知识传给学生模型。#Hinton et al., 2015
参考来源
- Hinton, G. et al. (2015). Distilling the Knowledge in a Neural Network. arXiv:1503.02531
Shortcode
Shortcode 语法
普通高亮:默认高亮文字。
彩色高亮:黄色高亮、红色高亮、蓝色高亮、绿色高亮、紫色高亮。
点击展开
隐藏内容。details shortcode 必须成对出现,不要拆到多个
标签里。
Code Tabs
流程图与算法伪代码
当 Mermaid 流程图和 Algorithm 伪代码描述同一过程时,优先放进同一个 code-tabs 区块,避免正文纵向堆叠过长。
flowchart TD A["输入"] --> B["处理"] B --> C["输出"]
Algorithm: Example
Input: x
repeat
y = step(x)
until convergence
Output: y
Mermaid
图表类型一览
本站支持流程图、思维导图、象限图、时间线、状态图、时序图、分支图等。硬性规则:节点/边标签含括号、斜杠、冒号、中英文混排时必须加引号,否则 Mermaid v11 运行时解析失败导致整图不渲染。完整类型与示例见 blog-syntax/references/mermaid.md。
flowchart LR
A["输入"] --> B["处理"]
B --> C{"判断"}
C -->|"是"| D["输出"]
C -->|"否"| A
mindmap
root(("主题"))
分支一
"子节点 A"
"子节点 B"
分支二
"子节点 C"
References
写作规范小结
收尾检查清单
- 图片路径:用
media/images/<slug>/<file>,禁止assets/media。 - display math:不要包进
<p>,让 MathJax 默认居中。 - 小节标题:正文小标题用
<h3 class="section-title">。 - sources:每条参考来源必须带
data-cite-key。 - Mermaid:特殊字符标签加引号,shortcode 必须成对闭合。