# obsidian-todocards

**Repository Path**: azlll/obsidian-todocards

## Basic Information

- **Project Name**: obsidian-todocards
- **Description**: No description available
- **Primary Language**: JavaScript
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-30
- **Last Updated**: 2026-04-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<!-- Language Switcher -->
[English](README.md) | [简体中文](README_zh.md)

# Todo Cards（待办卡片）

将笔记中的文字列表，通过右键菜单快速转换为可交互的卡片式待办清单。

## 功能特性

- **右键转换** — 在编辑器中选中文本，右键点击「Convert to Cards」，即可将列表渲染为可视化卡片布局
- **卡片网格** — 任务以响应式 CSS Grid 卡片形式展示，支持自定义列数
- **复选框同步** — 点击卡片复选框切换状态，变更自动写回源文件
- **内联编辑** — 直接点击卡片文字进行编辑，失焦后自动保存
- **拖拽排序** — 拖拽卡片即可调整顺序，排序结果同步回源文件

## 安装

### 通过社区插件市场

1. 打开 Obsidian 设置 → 第三方插件
2. 搜索「Todo Cards」
3. 安装并启用

### 手动安装

1. 从 [最新 Release](https://gitee.com/zhulei-personal/obsidian-todocards/releases) 下载 `main.js`、`manifest.json`、`styles.css`
2. 将三个文件复制到仓库的 `.obsidian/plugins/todocards/` 目录
3. 在「设置 → 第三方插件」中启用插件

## 使用方法

1. 在编辑器中编写任务列表：

   ```markdown
   - [ ] 采购日用品
   - [ ] 打扫房间
   - [x] 完成报告
   ```

2. 选中列表，右键选择 **Convert to Cards**
3. 列表即渲染为交互式卡片
4. 点击复选框切换状态，点击文字编辑内容，拖拽卡片调整顺序

## 开发

```bash
# 安装依赖
npm install

# 开发模式（热更新）
npm run dev

# 生产构建
npm run build
```

## 开源协议

MIT