Stats
Actions
Tags
From siyuan
Edits SiYuan-flavored Markdown (SFMD) with wiki links, block quotes/embeds, attributes, SQL queries. Use for SiYuan .md files, double-chain syntax, image insertion via Python script.
How this skill is triggered — by the user, by Claude, or both
Slash command
/siyuan:siyuan-markdownThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
思源笔记风味 Markdown 是在标准 Markdown 基础上扩展的一套语法，支持块级引用、双向链接、属性查询、SQL 嵌入等思源笔记特有的功能。
思源笔记风味 Markdown 是在标准 Markdown 基础上扩展的一套语法，支持块级引用、双向链接、属性查询、SQL 嵌入等思源笔记特有的功能。
[[文档名称]] // 链接到同名文档
[[文档名称|显示别名]] // 链接到文档并显示自定义名称
((块ID)) // 引用特定块
每个思源笔记块都有唯一的块 ID，格式类似 20250125000000-1a2b3c4d。
siyuan://blocks/块ID // 使用 siyuan:// 协议直接跳转到块
思源笔记提供三种块引用方式：
右键点击内容块 → 复制 → 引用块
> ((20250125000000-1a2b3c4d))
右键点击内容块 → 复制 → 嵌入块
嵌入块直接显示原始内容，保留格式和样式。
允许跳转到笔记内的任意块，是比文档小一级的基本单位。
> 这是一段引用文本
这是一段 `行内代码` 示例
**粗体文本**
*斜体文本*
***粗斜体文本***
~~删除线文本~~
<u>下划线文本</u>
思源笔记支持自定义属性功能。
可以为任意块添加自定义属性，通过思源笔记界面设置或通过 API 添加。
```sql
SELECT * FROM blocks WHERE type='d'
使用 SQL 查询来动态获取和显示块内容。
### 标签系统
```markdown
#标签名
支持文档树和块引重构的标签系统。
- 列表项 1
- 列表项 2
- 子列表项 2.1
- 子列表项 2.2
1. 列表项 1
2. 列表项 2
1. 子列表项 2.1
2. 子列表项 2.2
- [ ] 未完成任务
- [x] 已完成任务
\```python
def hello():
print("Hello, SiYuan!")
\```
支持 200+ 编程语言的语法高亮。
| 列 1 | 列 2 | 列 3 |
|------|------|------|
| 数据 1 | 数据 2 | 数据 3 |
| 数据 4 | 数据 5 | 数据 6 |
$E = mc^2$
$$
f(x) = \int_{-\infty}^{\infty} e^{-x^2} dx
$$
思源笔记会自动将图片资源存储在 assets/ 目录下。
当需要在现有文档中插入图片时，使用 insert_image.py 脚本。
# 插入本地 assets 图片
python scripts/insert_image.py "文档标题" "assets/image.svg" "图片说明"
# 插入 URL 图片
python scripts/insert_image.py "文档标题" "https://example.com/image.png" "图片说明" --url
| 参数 | 说明 | 示例 |
|---|---|---|
doc_title | 目标文档标题（支持部分匹配） | "我的笔记" |
image_path | 图片路径 | assets/diagram.svg 或 https://example.com/image.png |
caption | 图片说明文字（可选） | "流程图" |
--url | 标识图片路径为 URL（可选） | --url |
成功: SUCCESS|块ID|消息
失败: ERROR|错误消息
# 插入本地 SVG 流程图
python scripts/insert_image.py "流程图示例_WebDAV" "assets/excalidraw-flowchart-20260125.svg" "用户注册流程"
# 插入网络图片
python scripts/insert_image.py "技术文档" "https://example.com/architecture.png" "系统架构图" --url
当需要创建图表、流程图、思维导图、架构图或可视化内容时，优先调用 siyuan-excalidraw skill 进行绘图。
siyuan-excalidraw skill 生成图表
示例：
[链接文本](https://example.com)
[链接文本](path/to/file.md)
---
或
***
这是一段文本[^1]
[^1]: 这是脚注内容
所有块都支持聚焦编辑，提高写作专注度。
在上下文中轻松切换文档路径。
支持多层级列表折叠。
支持块的横向排列，适合并排显示多个内容块。
# 思源笔记示例文档
这是一篇关于思源笔记的示例文档。
## 维基链接示例
你可以链接到 [[技术笔记]] 或 [[项目计划|我的项目计划]]。
也可以引用特定的块：((20250125000000-1a2b3c4d))
## 嵌入和引用
> 这是一段引用块，可以 ((嵌入其他块))
## 列表示例
### 任务清单
- [ ] 学习思源笔记基本语法
- [x] 安装思源笔记
- [ ] 创建第一个笔记
### 项目清单
1. 需求分析
2. 系统设计
3. 开发实现
4. 测试上线
## 代码示例
```python
# 思源笔记 API 示例
import requests
def create_block(content):
url = "http://localhost:6806/api/block/insertBlock"
data = {
"dataType": "markdown",
"data": content,
"previousID": ""
}
response = requests.post(url, json=data)
return response.json()
| 功能 | 描述 | 快捷键 |
|---|---|---|
| 双向链接 | 文档间的相互链接 | [[ |
| 块引用 | 引用任意内容块 | (( |
| 属性面板 | 查看和编辑属性 | Alt + P |
质能方程：$E = mc^2$
高斯积分： $$ \int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi} $$
#思源笔记 #知识管理 #双链
## 注意事项
1. **块 ID**：思源笔记会自动为每个块分配唯一的 ID，格式为 `日期时间-随机字符`
2. **资源路径**：图片等资源默认存储在 `assets/` 目录下
3. **Markdown 兼容性**：思源笔记支持导出标准 Markdown，但双向链接等特性在标准 Markdown 中无法体现
4. **版本兼容**：思源笔记的 .sy.zip 格式包含所有资源和元数据，用于完整备份
## 参考
- [思源笔记官方文档](https://b3log.org/siyuan/)
- [思源笔记 GitHub 仓库](https://github.com/siyuan-note/siyuan)
- [思源笔记 API 文档](https://b3log.org/siyuan/zh-Hans/api/)
npx claudepluginhub zhiluop/siyuan-skills --plugin siyuanProvides SiYuan Notes core knowledge: content blocks, references, embeds, API calls, templates, flashcards. Use for basic concepts, API principles, block syntax, template development, general operations.
Writes correct Obsidian Flavored Markdown: wikilinks, embeds, callouts, properties, tags, highlights, math, and canvas syntax. Reference when creating or editing any wiki page.
Creates and edits Obsidian Markdown with wikilinks, embeds for notes/images/PDFs/audio/video, callouts, YAML frontmatter/properties, tags, and block references. For .md files in Obsidian vaults.