Back to Details

obsidian-todoist-sync

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Obsidian Todoist Plugin (Sync with Todoist, v2.6.0)

Obsidian Todoist 插件（同步 Todoist，v2.6.0）

An unofficial plugin that integrates Todoist tasks into your Obsidian vault. Primarily one-way sync (Todoist → Obsidian), with limited ability to create tasks from Obsidian. Works on desktop and mobile.
这是一款非官方插件，可将 Todoist 任务集成到你的 Obsidian 库中。主要为单向同步（Todoist → Obsidian），支持从 Obsidian 创建任务的功能有限，可在桌面端和移动端使用。

Reference files

参考文件

Load these only when the user's question requires the detail:
FileWhen to read
references/query-blocks.md
User asks about embedding tasks, query syntax, filter options, sorting, groupBy, show, autorefresh, view
references/commands-and-config.md
User asks about add task command, sync command, or any plugin configuration setting
仅当用户的问题需要详细说明时才加载以下文件：
文件读取时机
references/query-blocks.md
用户询问嵌入任务、查询语法、过滤选项、排序、groupBy、show、autorefresh、view 相关内容时
references/commands-and-config.md
用户询问添加任务命令、同步命令或任何插件配置设置时

1. Installation

1. 安装

Via Obsidian (recommended): Open this link in Obsidian: 
obsidian://show-plugin?id=todoist-sync-plugin
Or visit: https://obsidian.md/plugins?id=todoist-sync-plugin
Manual:
  1. Settings → Community Plugins → enable community plugins
  2. Browse → search "Todoist Sync" → Install → Enable
通过 Obsidian 安装（推荐）： 在 Obsidian 中打开此链接：
obsidian://show-plugin?id=todoist-sync-plugin
或访问：https://obsidian.md/plugins?id=todoist-sync-plugin
手动安装：
  1. 设置 → 社区插件 → 启用社区插件
  2. 浏览 → 搜索 "Todoist Sync" → 安装 → 启用

2. API Token Setup

2. API Token 设置

After enabling the plugin:
  1. A popup asks for your Todoist API token
  2. Enter the token directly or use "Paste from clipboard"
  3. A checkmark appears if the token is valid
  4. Click Save
Token is stored in Obsidian's built-in secret storage by default. File-based storage (
.obsidian/todoist-token
) is available in configuration — avoid syncing that file if you share your vault.
启用插件后：
  1. 会弹出窗口要求输入你的 Todoist API token
  2. 直接输入 token 或使用“从剪贴板粘贴”
  3. 如果 token 有效，会显示一个对勾
  4. 点击 保存
默认情况下，Token 存储在 Obsidian 的内置保密存储中。配置中也支持基于文件的存储（
.obsidian/todoist-token
）——如果你共享库，请不要同步该文件。

3. Quick Start

3. 快速入门

Embed tasks in a note:
```todoist
filter: "today | overdue"
```
Only 
filter
is required. All other options (
name
, 
autorefresh
, 
sorting
, 
groupBy
, 
show
, 
view
) are optional. → For full query block reference, read 
references/query-blocks.md
Add a task from Obsidian: Command Palette → "Add task" (pre-populates with any selected text) → For command variants and configuration, read 
references/commands-and-config.md
在笔记中嵌入任务：
```todoist
filter: "today | overdue"
```
仅需必填项 
filter
。其他所有选项（
name
、
autorefresh
、
sorting
、
groupBy
、
show
、
view
）均为可选。 → 如需完整的查询块参考，请阅读 
references/query-blocks.md
从 Obsidian 添加任务： 命令面板 → "Add task"（会自动填充选中的文本） → 如需了解命令变体和配置，请阅读 
references/commands-and-config.md

Docs

文档

https://jamiebrynes7.github.io/obsidian-todoist-plugin/docs/setup
https://jamiebrynes7.github.io/obsidian-todoist-plugin/docs/setup