> ## Documentation Index
> Fetch the complete documentation index at: https://cogno.studio/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# タスクをエクスポート

> タスクをMarkdown / JSON / CSVでエクスポート（絞り込み可）。データはあなたのもの、どこでも読めるオープンな形式で。

Cognoではいつでもタスクを外に持ち出せます。**設定 → 一般 → タスクをエクスポート**
から **エクスポート** モーダルを開き、形式（Markdown / JSON / CSV）と任意の絞り込みを選んでダウンロードします。これは[タスクのインポート](/docs/ja/task-import.md)の対になる機能で、
CSV形式は取り込み直せます。

## 含まれるもの

* 各タスクの完全な持ち出し可能な状態（古い順）: タイトル・ステータス・説明・プロジェクト（名前）・親（タイトル）・担当者/コラボレーター（名前）・タグ・期日/開始日・ボードの並び順（position）・繰り返し・source/metadata。
* 操作できない内部IDは持ち出し可能な値に解決します（プロジェクトは**名前**、親は親タスクの**タイトル**、人は**名前**）。他ツールでも意味を持ちます。

### 絞り込み

モーダルでは **ステータス** / **プロジェクト** / **担当者** / **開始**・**終了**
（各タスクの開始〜期日ウィンドウで判定）で絞り込めます。既定ではライブなステータスを出力し、**アーカイブと却下はオフ**です — 含める場合はチップを選択してください。全ステータスを選択（かつ他の絞り込みを空に）すると全タスクを出力します。

> [!NOTE]
>
> タスクの共同編集の履歴は出力されません。出力されるのは現在の説明テキストです。

## 形式

> **Markdown**
>
> 読みやすい1つの `.md` 文書 — タスクごとに見出し + ステータス・プロジェクト・担当者・タグ・期日・説明。読む/共有する用途に最適。

> **JSON**
>
> 構造化された `.json` — タスクごとの**完全な**状態。スクリプト・バックアップ・ツール向け。

> **CSV**
>
> 表計算向けの `.csv`（importer互換の列）。ExcelやSheetsで開け、
> **インポートでタスクを一括作成**できます（ベストエフォート。CSVの注意参照）。

ダウンロードされるファイル名は `cogno-<ワークスペース>-tasks.<拡張子>` です。

## JSON — 完全なタスク状態

JSONが最も完全な形です。各タスクが持ち出し可能な全フィールドを持ちます:

```json theme={"system"}
{
  "workspace_id": 39,
  "workspace_title": "Acme",
  "exported_at": "2026-07-19T09:12:00+00:00",
  "task_count": 128,
  "tasks": [
    {
      "id": 12,
      "title": "エクスポートボタンを出荷",
      "status": "active",
      "description": "Markdown/JSON/CSV エクスポートを追加。",
      "project": "Platform",
      "parent_id": null,
      "parent_title": null,
      "assignee": { "name": "Ada Lovelace", "workspace_member_id": 41 },
      "collaborators": [{ "name": "Grace Hopper", "workspace_member_id": 42 }],
      "tags": [{ "name": "backend", "color": "#4285F4" }],
      "due_date": "2026-07-25",
      "start_date": "2026-07-20",
      "position": 1,
      "source_type": "slack_channel",
      "source_id": null,
      "source_url": "https://acme.slack.com/archives/C1/p1",
      "metadata": {},
      "intents": null,
      "created_at": "2026-07-10T04:20:00+00:00",
      "updated_at": "2026-07-18T22:00:00+00:00"
    }
  ]
}
```

**意図的な除外:** 共同編集のCRDTブロブと説明のバージョン履歴（読めるテキストは
`description`）、派生のサブタスク数。それ以外 — 担当者/コラボレーターの役割やボードの `position` を含む — は保持します。

## CSV — 表計算と再インポート

CSVは[タスクのインポート](/docs/ja/task-import.md)が期待する列に合わせ、**内部IDではなく名前・参照**で出力するので、表計算で編集してタスクを作成できます:

| 列 | 補足 |
| - | - |
| `Title` | タスクのタイトル（インポート時は必須）。 |
| `Description` | タスクの説明。 |
| `Status` | ワークフローのステータス。 |
| `Assignee` | 主担当者の**名前**。 |
| `Collaborators` | コラボレーターの**名前**（担当者とは別に保持）。 |
| `Due date` / `Start date` | `YYYY-MM-DD`。 |
| `Project` | プロジェクト**名**（インポートが検索または作成）。 |
| `Parent` | 親タスクの**タイトル**（1階層の親子を復元）。 |
| `Source` | 元のソースURL（あれば）。 |
| `Tags` | カンマ区切りのタグ名。 |

> [!WARNING]
>
> CSVの取り込みは**ベストエフォートで、完全なバックアップではありません**。再インポート時:
>
> * **タグ**は実タグではなくmetadataとして保存されます。
> * **説明の書式**（改行・空行）はimporterにより正規化されます。
> * **親**はタイトルで照合するため、ファイル内で親タイトルが一意である必要があります。
> * **担当者/コラボレーター**は、取り込み先に名前/メールが一致するメンバーがいる場合のみ再リンクされます。
>
> 忠実なコピーには **JSON** を使ってください。

`=`・`+`・`-`・`@` で始まるセルは `'` を付けて無害化し、CSVを表計算で開いたときにタスクのタイトルや説明が数式として実行されないようにしています。

## 関連ドキュメント

* [CSVからタスクをインポート](/docs/ja/task-import.md) — インポートの対になる機能。
* [タスク](/docs/ja/tasks.md) — タスクとは何か、Cognoの中でどう流れるか。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.