Quick Start Guide

Create your first board in 5 minutes

快速入门

本指南将使用 Markdown 面板在 5 分钟内引导您从空板到工作看板设置。

ℹ️

Note

开始之前：打开您的看板，单击 Markdown 按钮，并确保您位于“编辑器”选项卡中。

第 1 步 - 定义您的列

在 columns 数组内，为每个工作流程阶段添加一个对象。每个都需要一个 id、title、color 和 order。

JSON

{
  "version": 1,
  "board": {
    "id": "my-board-001",
    "title": "My First Board"
  },
  "columns": [
    { "id": "todo",  "title": "To Do",  "color": "#64748b", "order": 0 },
    { "id": "doing", "title": "Doing",  "color": "#6366f1", "order": 1 },
    { "id": "done",  "title": "Done",   "color": "#10b981", "order": 2 }
  ],
  "tasks": []
}

一个最小的 3 栏板，还没有任务

💡

Tip

在此步骤之后运行试运行，以在添加任务之前确认您的列有效。

第 2 步 — 添加任务

填充 tasks 数组。在每个任务的 columnId 字段中引用您的列 ID。

JSON

"tasks": [
  {
    "id": "task-001",
    "columnId": "todo",
    "position": 0,
    "title": "Set up project structure",
    "description": "Initialize repo, install dependencies.",
    "priority": "high",
    "tags": ["setup"],
    "assigneeIds": [],
    "mentionMemberIds": [],
    "estimatePoints": 2,
    "dueDate": null,
    "plannedStartAt": null,
    "plannedEndAt": null,
    "timeboxMinutes": null,
    "isCompleted": false,
    "archivedAt": null,
    "checklist": [
      { "title": "Init git repo", "isDone": true },
      { "title": "Add .gitignore", "isDone": false }
    ]
  }
]

待办事项列中的第一项任务，包含 2 项清单

第 3 步 — 试运行，然后应用

单击试运行 — 确认 ok: true 并查看差异摘要
修复任何诊断错误（如果存在）
点击应用 — 您的主板会立即更新

💡

后续步骤

请参阅所有任务字段的完整 Markdown 和 JSON 参考，包括受让人、时间盒、笔记中的美人鱼图和存档。