# RemUp 语法速查表

## 📋 一分钟上手指南

### 基础语法

```
┌─────────────┬──────────────────┬──────────────────┐
│   功能      │   传统语法       │   极简语法       │
├─────────────┼──────────────────┼──────────────────┤
│  归档定义   │ --<名称>--       │ # 名称           │
│  卡片开始   │ <+主题           │ ## 主题          │
│  卡片结束   │ /+>              │ (自动结束)       │
│  区域划分   │ ---区域名        │ ### 区域名       │
│  次级卡片   │ (不支持)         │ #### 主题        │
│  重要标签   │ (!: 内容)        │ (不支持)         │
│  参考链接   │ (>: #目标)       │ (不支持)         │
│  注卡批注   │ `内容 `[批注]     │ [内容 | 批注]     │
│  行内解释   │ >>解释           │ ^解释            │
└─────────────┴──────────────────┴──────────────────┘
```

**注意**：标签统一使用传统语法 `(符号：内容)`，不使用 `[@]` 格式。

---

## 🎯 快速示例

### 完整示例（推荐）

```remup
# 学习笔记

## Python 基础
(!: 重点) (>: #进阶)

### 变量
`变量`[存储数据的容器] ^编程概念

### 函数
def greet(name): ^定义函数
    return f"Hello, {name}"

/+>
```

---

## ✨ 核心特性

### 1️⃣ 结构化组织

```remup
# 归档名          ← 第一级：大主题分组
## 卡片主题       ← 第二级：知识点单元（可选）
### 区域名        ← 第三级：知识的某个方面
#### 次级卡片     ← 第四级：更细的分组
```

**智能结束机制**：
- 极简语法 `##` → 遇到下一个 `##`/`#`/文件结尾 自动结束
- 传统语法 `<+` → 需要 `/+>` 显式结束

### 2️⃣ 标签系统

```remup
(!: 重要)         ← 标记为重点（红色高亮）
(>: #其他)        ← 链接到其他卡片（蓝色链接）
(*: ⭐⭐⭐)         ← 星级评价
(备注：说明)      ← 普通备注（灰色）
```

**多个标签**可以放在同一行，用空格分隔：

```remup
## 知识点
(!: 核心) (参考:#前置) (难度:⭐⭐⭐)
```

### 3️⃣ 交互式批注

```remup
# 注卡语法
`术语`[解释说明]

# 示例
Python`[编程语言]`是一门优雅的语言
装饰器`[高级特性]`用于增强函数功能
```

**悬停效果**：鼠标移到带下划线的内容上查看批注

### 4️⃣ 行内解释

```remup
# 语法
概念描述 ^简短解释

# 示例
变量是存储数据的容器 ^就像贴标签
函数是可复用的代码块 ^提高开发效率
```

---

## 📝 标签符号详解

### 常用符号类型

| 符号 | 名称 | 用途 | 渲染样式 |
|-----|------|------|---------|
| `!` | 感叹号 | 重要/基础/警告 | 🔴 红色高亮 |
| `>` | 大于号 | 引用/链接/跳转 | 🔗 蓝色链接 |
| `*` | 星号 | 等级/评分/重点程度 | ⭐ 星级显示 |
| 其他文字 | 自定义 | 备注/说明/分类 | ⚪ 灰色普通 |

### 标签组合使用

```remup
## 函数进阶
(!: 核心知识) (前置:#函数基础) (难度:⭐⭐⭐) (考试:必考)

### 内容
...
```

---

## 🎓 实战模板

### 学习笔记模板

```remup
# 课程名称 - 章节标题

(!: 重点复习) (考试:⭐⭐⭐)

## 核心概念 1
(!: 基础)

### 定义
关键概念的定义和解释

### 示例
- 例子 1 `术语`[简单说明]
- 例子 2 `概念`[详细解释]

## 核心概念 2
(!: 进阶) (前置:#核心概念 1)

### 应用场景
实际使用场景 ^加深理解

### 注意事项
- 注意点 1 ^常见错误
- 注意点 2 ^易混淆点

/+>
```

### 复习卡片模板

```remup
# 复习专题

## 知识点 A
(!: 必考) (*: ⭐⭐⭐)

### 核心要点
- 要点 1 ^关键词
- 要点 2 ^关键词

### 常考题型
1. 选择题 ^掌握
2. 简答题 ^理解

## 知识点 B
(!: 重要) (关联:#知识点 A)

### 对比记忆
vs`[对比 A]`^区别与联系
vs`[对比 B]`^相同与不同

/+>
```

---

## ⚠️ 常见错误

### ❌ 错误示范

```remup
# 错误 1：混用标签语法
[@重要] (!: 基础)  ← 不要这样！

# 错误 2：忘记卡片结束（传统语法）
<+卡片
内容...
← 缺少 /+>

# 错误 3：标签格式错误
(重要)  ← 缺少冒号
(: 内容)  ← 缺少符号
```

### ✅ 正确做法

```remup
# 统一使用传统标签
(!: 重要) (!: 基础)

# 传统语法需要结束标记
<+卡片
内容...
/+>

# 正确的标签格式
(!: 内容) (符号：内容)
```

---

## 🔧 高级用法

### 跨卡片引用

```remup
## 当前卡片
(>: #目标卡片) ← 创建链接

## 目标卡片  
(!: 被引用) ← 可以作为复习索引
```

### 知识网络构建

```remup
# Python 知识体系

## 基础篇
(!: 入门) (系列:#Python)

### 变量
(前置:无) (后续:#数据类型)

### 数据类型
(前置:#变量) (后续:#函数)

## 进阶篇
(!: 提高) (系列:#Python)

### 函数
(前置:#数据类型) (后续:#装饰器)

### 装饰器
(前置:#函数) (难度:⭐⭐⭐⭐)

/+>
```

---

## 🚀 最佳实践

### 推荐的笔记结构

```
1. 归档命名清晰 → # Python 学习笔记
2. 卡片主题明确 → ## 变量与数据类型  
3. 区域分类合理 → ### 基本概念 / ### 示例
4. 标签使用规范 → (!: 重点) (难度:⭐⭐)
5. 注画龙点睛 → `关键术语`[简明解释]
```

### 内容编写建议

- ✅ **一个卡片一个主题** - 保持专注
- ✅ **区域之间有关联** - 逻辑递进
- ✅ **标签准确描述** - 便于检索
- ✅ **注卡解释难点** - 不是所有词都需要注卡
- ✅ **行内解释补充** - 简短而精准

---

## 💡 技巧总结

### 高效记笔记

1. **先写归档** - 确定大方向
2. **再列卡片** - 分解知识点
3. **填充区域** - 详细内容
4. **添加标签** - 标注重点和关联
5. **插入注卡** - 解释术语
6. **最后检查** - 确保结构清晰

### 复习优化

- 使用 `(!: 必考)` 标记重点
- 使用 `(>: #相关)` 建立联系
- 使用 `(*: ⭐⭐⭐)` 标注难度
- 定期整理标签体系

---

*RemUp v5.1 - 经典语法，高效学习！*

**记住：好的工具 + 好的方法 = 好的效果！** 🎉