乐于分享
好东西不私藏

我用DS手搓了一个卡片软件...

我用DS手搓了一个卡片软件...

MathCards 🃏

独立桌面记忆卡片软件。支持完整 Markdown 语法 + LaTeX 数学公式(覆盖 Markdown Preview Enhanced),卡片以 .md 文件存储,Electron 构建,单个 .exe 双击即用。


📦 安装

从 Releases 下载 MathCards.exe,双击运行。需 Windows 10/11 64 位,无需安装其他依赖。


📖 核心概念

一张卡片 = 一个 .md 文件。

所有卡片以 Markdown 文件形式存储在电脑上,文件格式:

## 正面

问题或提示(支持 Markdown + LaTeX)

## 反面

答案或解释

卡片按文件夹组织,每个文件夹独立复习,互不干扰。


🖥️ 界面布局

┌─────────────────────────────────────────────────┐
│  📂 文件夹           │  主区域                   │
│                      │                          │
│  📁 高数             │  📁 高数            [🗑]  │
│  📁 英语             │                          │
│  📁 默认文件夹        │  [+新建卡片] [📂导入]    │
│                      │  [📄导出合并] [▶开始复习] │
│  [+新建文件夹]        │                         │
│  ────────            │  · 极限与连续.md   错1    │
│  ❌ 错题             │  · 导数定义.md            │
│  ├ 📁 高数           │  · 积分公式.md            │
│  │ ├ 错1次 (2)       │                          │
│  │ └ 错2次 (1)       │                          │
│  └ 📁 英语           │                          │
│    └ 错1次 (1)       │                           │
└─────────────────────────────────────────────────┘
区域
说明
左侧栏
文件夹列表 + 错题列表
主区域
卡片列表 / 复习界面 / 编辑器

📁 文件夹管理

创建文件夹

点击左侧 「+新建文件夹」,输入名称即可。

切换文件夹

点击左侧文件夹列表中的任意文件夹。

右键菜单

在文件夹上右键弹出菜单:

选项
功能
▶ 开始复习
进入该文件夹的复习模式
✏️ 重命名
修改文件夹名称
🗑 删除
删除文件夹及其全部卡片
📂 文件位置
在文件管理器中打开该文件夹
📄 导出合并 .md
将所有卡片合并为一个 .md 文件

删除文件夹

点击顶部 「🗑」 按钮或右键 → 删除。


🃏 创建卡片

手动创建

  1. 选中一个文件夹
  2. 点击 「+新建卡片」
  3. 在编辑器中分别填写正面和反面内容(支持 Markdown + LaTeX)
  4. 右侧实时预览可查看渲染效果
  5. 点击 「💾 保存」,自动生成 .md 文件

批量导入

  1. 选中目标文件夹
  2. 点击 「📂 导入 .md」
  3. 选择一个 .md 文件
  4. 输入卡片分隔记号(默认 ##)—— 文件按此记号切分为多张卡片
  5. 输入正反分隔记号(默认 ### 解答)—— 每张卡片按此记号分为正面和反面
  6. 系统自动生成多张卡片到当前文件夹

编辑卡片

  • 点击卡片列表中的任意卡片进入编辑
  • 编辑器顶部有 「◀ 上一张」 / 「下一张 ▶」 按钮,可快速切换
  • 保存当前卡片后自动跳转
  • 点击 「🗑 删除」 可删除当前卡片

🔄 复习模式

开始复习

选中文件夹后点击 「▶ 开始复习」 或右键 → 开始复习。

复习流程

展示正面(问题)
      │
   点击卡片
      │
      ▼
展示反面(答案)
      │
  ┌───┴───┐
  │       │
  ▼       ▼
✅ 认识  ❌ 不认识
  │       │
  │       └── 插回队列,稍后再次出现
  │
  └── 移出本轮队列

复习完成后 → 🎉 复习完成!→ 点击「返回」

进度显示

复习页面顶部显示:第 3 / 10(当前第 3 张,共 10 张)。

退出复习

点击 「← 返回」 可随时退出,错题变化会自动保存。


❌ 错题系统

错题按来源文件夹分区,不同文件夹的错题互不干扰。

错题列表(左侧栏)

📂 错题
├── 📁 高数
│   ├── 错1次 (2 张)
│   └── 错2次 (1 张)
└── 📁 英语
    └── 错1次 (1 张)

规则

复习时操作
复习结束时效果
点击 ❌ 不认识
该卡片 errorCount++
点击 ✅ 认识(且原本有错)
该卡片 errorCount--
点击 ✅ 认识(原本没错)
不变
减至 0
自动移出错题列表

错题专项复习

点击错题列表中的 「错N次 (N张)」,只复习该错误次数的卡片。


📄 导出合并

选中文件夹后,点击 「📄 导出合并」 或右键 → 导出合并 .md。

  • 将该文件夹下所有卡片按文件名顺序拼接
  • 每张卡片之间用 --- 分隔
  • 生成 _合并_文件夹名.md 保存在同一目录
  • _ 开头的文件不会出现在卡片列表和复习中

✨ 支持的 Markdown 语法

类别
语法
基础
标题、粗体、斜体、删除线、列表、引用、链接、图片、表格
代码
行内代码 `code`、代码块 ```(190+ 语言语法高亮)
LaTeX 内联
$...$
、\(...\)
LaTeX 块级
$$...$$
、\[...\](支持 \tag、\label、\ce 化学式等)
LaTeX 环境
aligned
、cases、matrix、pmatrix 等(KaTeX 原生支持)
扩展
任务列表 - [x]、脚注、下标、上标、高亮 ==text==
图表
Mermaid(流程图、时序图等)

渲染效果与 VS Code 的 Markdown Preview Enhanced 插件一致(含 KaTeX 字体)。


💾 数据存储

卡片数据存储在:

C:\Users\<你的用户名>\AppData\Roaming\mathcards\cards\

每个文件夹对应一个子目录,每张卡片对应一个 .md 文件。你可以直接用任何 Markdown 编辑器打开编辑。


🛠 开发

git clone https://github.com/WenjeMa/MathCards.git
cd MathCards
npm install
npm start        # 启动开发窗口
npm run pack     # 打包为便携版 .exe

国内网络环境下若 Electron 下载失败:

$env:ELECTRON_MIRROR="https://npmmirror.com/mirrors/electron/"
npm install

📄 License

MIT © WenjeMa

相关学习资料