Inkstone Markdown 完整语法指南与全景演示

1. 标题与块级锚点

Inkstone 支持标准的 6 级标题，每个标题均会自动生成对应的锚点链接，同时支持在段落或标题末尾附加块引用 ID。

一级标题 (Heading 1)

二级标题 (Heading 2)

三级标题 (Heading 3)

四级标题 (Heading 4)

五级标题 (Heading 5)

六级标题 (Heading 6)

这是一个带有块引用锚点的普通段落。 ^demo-paragraph-anchor

2. 基础文本与高级行内样式

2.1 Ruby 旁注注音 (East Asian Ruby Annotations)

支持通过 {汉字|注音} 或 [汉字]{注音} 为文字标注汉语拼音、日文假名或英译旁注：

• 汉语拼音：汉字hàn zì 与 注音(zhù yīn)
• 日文假名：日本にほん 与 東京(とうきょう)

2.2 Emoji 短代码 (Emoji Shortcodes)

不仅支持直接输入 Unicode Emoji，还支持标准 Emoji 短代码自动转义：

• 😄 :smile:
• 🎉 :tada:
• 🔥 :fire:
• 🚀 :rocket:
• ⭐ :star:
• 💡 :bulb:
• ✅ :white_check_mark:
• ⚠️ :warning:
• ❤️ :heart:
• 👍 :+1:

2.3 缩写词悬浮释义 (Abbreviations)

在文章任意位置（通常在文末或专门区域）声明缩写词定义，正文出现的对应缩写词将自动带有悬浮释义浮窗与虚下划线：

HTML 与 CSS 是现代 Web 开发的基础规范。

3. 词条定义列表 (Definition Lists)

词条定义列表提供语义化的 <dl>、<dt>、<dd> 结构，常用于术语表、名词解释与功能清单：

Inkstone

基于 Cloudflare 全球边缘网络与 D1 数据库构建的现代化跨平台本地笔记系统。

深度集成双向链接、Mermaid 图表、JavaScript 交互运行与全量设计令牌。

Markdown

一种由约翰·格鲁伯创建的轻量级标记语言，允许人们使用易读易写的纯文本格式编写文档。

4. 列表与扩展任务列表

4.1 普通无序与有序列表

• 无序列表项 1
  • 多级嵌套缩进项 A
  • 多级嵌套缩进项 B
• 无序列表项 2

1. 第一阶段：需求调研与架构设计
2. 第二阶段：核心渲染器与扩展插件接入
3. 第三阶段：自动化回归测试与性能压测

4.2 全状态任务列表 (Extended Task Lists)

支持标准 GFM 待办与已完成，以及丰富的进行中、取消、待定与重点状态标记：

• 待办任务（未勾选状态）
• 已完成任务（勾选状态）
• 进行中任务（Half-check / In-progress 标记）
• 已取消 / 放弃任务（Cancelled 划线置灰标记）
• 疑问待定任务（Question 标记）
• 重点关注任务（Important 红色警告标记）

5. 双向链接、标签与笔记嵌入

5.1 双链与别名

• 标准双向链接：架构总纲
• 带有自定义别名的双向链接：查看引擎设计文档

5.2 块引用

• 引用本文档内部或外部笔记的特定块：((demo-paragraph-anchor))

5.3 标签系统

• 一级普通标签：#笔记
• 多级嵌套层级标签：#项目/云端架构

5.4 笔记嵌入

可以将其他笔记的内容直接作为实时子卡片嵌入到当前笔记中：

5.5 隐藏注释 (Obsidian Comments)

在正文中使用百分号括起的注释内容，在编辑视图可见，但在渲染与导出视图会自动忽略：

6. 引用块与 Callout 提示卡片

6.1 常规多级引用

知识不是孤立的岛屿，而是一座互联的网络。

引用支持深层嵌套，展示层级对话与引述关系。

6.2 Obsidian 风格 Callout 提示块

支持多种预设风格样式，包括可折叠提示框：

7. 容器组件：折叠块与标签页

7.1 折叠块 (Details Container)

7.2 标签页组 (Tabs Container)

8. 表格排版 (Tables)

9. 代码块与代码高亮

9.1 标准语言代码块（带标题与行号）

export function formatTimestamp(date: Date): string {
  const pad = (n: number) => n.toString().padStart(2, '0');
  const y = date.getFullYear();
  const m = pad(date.getMonth() + 1);
  const d = pad(date.getDate());
  return `${y}-${m}-${d}`;
}

9.2 增强型 Markdown 演示代码块 (md-example)

支持左侧渲染真实效果、右侧展示 Markdown 源代码：

**粗体与 ==高亮== 演示**
- [x] 已完成
- [/] 进行中
> 提示卡片内嵌

9.3 增强型 JavaScript 可运行代码块 (javascript-example)

右上角配有运行按钮与行号开关，点击运行后在右侧独立面板安全执行并输出结果：

const numbers = [10, 25, 38, 42, 60];
const total = numbers.reduce((acc, curr) => acc + curr, 0);
const average = total / numbers.length;
 
console.log("数据项:", numbers);
console.log("总计和:", total);
console.log("平均值:", average);

10. LaTeX / KaTeX 数学公式

10.1 行内公式

爱因斯坦质能方程为 $E = mc^2$，欧拉恒等式为 $e^{i\pi} + 1 = 0$。

10.2 块级公式

高斯积分与正态分布密度函数展开：

11. Mermaid 图表全景 (全部 14 种图表类型)

Inkstone 原生集成了完整版本的 Mermaid 引擎，支持以下全部 14 种图表类型：

11.1 业务流程图 (Flowchart)

11.2 时序交互图 (Sequence Diagram)

11.3 项目甘特图 (Gantt)

11.4 面向对象类图 (Class Diagram)

11.5 统计饼图 (Pie Chart)

11.6 状态机图 (State Diagram)

11.7 实体关系模型图 (Entity Relationship Diagram)

11.8 思维导图 (Mindmap)

11.9 时间线里程碑图 (Timeline)

11.10 用户旅程体验图 (User Journey)

11.11 四象限优先级矩阵 (Quadrant Chart)

11.12 Git 分支流图 (GitGraph)

11.13 C4 架构上下文图 (C4 Context)

11.14 敏捷看板图 (Kanban)

12. Chart.js 数据图表全景 (全部 7 种图表类型)

Inkstone 深度集成了 Chart.js 现代数据可视化引擎，只需使用以 chart 为语言标识的代码块并填写标准 JSON 结构，即可在笔记中直接渲染出交互式图表（支持悬浮提示、自适应宽度及深浅主题色彩匹配）：

12.1 柱状统计图 (Bar Chart)

12.2 折线走势图 (Line Chart)

12.3 占比饼图 (Pie Chart)

12.4 环形图 (Doughnut Chart)

12.5 多维雷达评估图 (Radar Chart)

12.6 极坐标面积图 (Polar Area Chart)

12.7 气泡分布矩阵图 (Bubble Chart)

13. 脚注 (Footnotes)

可以在正文任意位置插入带数字编号的脚注引用^[1]，然后在文末进行定义解释。