1. Open Obsidian's Settings window
2. Select the Community plugins tab on the left
3. Under Installed plugins, click the gear icon next to the TickTickSync plugin
4. Click Login to get started.

🚩

🚩

⚠️

⚠️

1. TickTick lists are referred to as Projects in the plugin, and throughout documentation.
2. TickTickSync back ups are now CSV files that are compatible with TickTick's "Import Backups."
3. All Task Deletion operations must be confirmed.
4. TickTick only has four priorities (High, Medium, Low, None). Please see Priority in Task Format for Task mapping of priority
5. Warning: TickTickSync automatically creates .md files corresponding with the lists/projects created in TickTick and downloads all tasks to them.
   If the files are deleted in Obsidian while the TickTickSync plugin is active, those Tasks will be deleted from TickTick. If you accidentally confirm that deletion: To recover those tasks, go to the "Trash" menu item on the TickTick interface and recover deleted tasks from there.
6. It is now possible control synchronization. Please see details here.

1. TickTick/Dida: Choose your home server
2. Login: on changing the home server, or if you are notified to login:
   1. Click on the Login button
   2. In the browser window: Login to your home server
   3. Close the browser window

1. Default folder location:
   By default, TickTickSync saves Task files to the vault root folder ("/"). To choose an alternative folder, search for or type in the new folder name.
2. Default project:
   Tasks are added to the default project associated with a file. If tasks are added to a file with no default project association, and no default project is set, tasks will go to the "Inbox". If you set a Default Project here, those tasks will go to that Project instead.

To limit the tasks TickTickSync will synchronize from TickTick to Obsidian you can select a tag or project(list). If a tag is entered, only tasks with that tag will be synchronized. If a project(list) is selected, only tasks in that project will be synchronized. If both are chosen only tasks with that tag in that project will be synchronized.")

When limiting project is chosen, only tasks in the file with the project default will be synchronized. All other tasks will be ignored.

When a limiting Tag any Task created in Obsidian with the tag #TickTick and the limiting tag, it will be added to TickTick.

Additionally, 1.0.36 introduced AND/OR capabilities see details here: Task Limiting Rules.

Examples:

Limiting Tag	Limiting Project	Task Tagged with	Task Location	Result
		#ticktick	N/A	Tasks can be updated from Obsidian or TickTick
#onlySync		#ticktick	N/A	Task can only be updated from Obsidian.
#onlySync		#ticktick #onlySync	N/A	Task can be updated from Obsidian and TickTick
	ThisListOnly	#ticktick	File who's default project is ThisListOnly	Task can be updated from Obsidian and TickTick
	ThisListOnly	#ticktick	Any other file	Task can only be updated from Obsidian.
#onlySync	ThisListOnly	#ticktick #onlySync	File that has default project of ThisListOnly	Task can be updated from Obsidian and TickTick
#onlySync	ThisListOnly	#ticktick	Any other file	Task can only be updated from Obsidian.
#onlySync	ThisListOnly	#ticktick #onlySync	Any other file	Task can only be updated from Obsidian.

1. Project:
   The Project/List containing tasks in order to be synchronized

2. Tag:
   The tag tasks must have in order to be synchronized.

3. Automatic synchronization interval time:
   The time interval for automatic synchronization is set to 300 seconds by default, which means it runs every 5 minutes. You can modify it yourself.

4. Full vault sync
   By enabling this option, the plugin will automatically add #ticktick to all tasks, which will modify all files in the vault. NOTE: This includes all tasks that are currently Items of a task.

Options to force manual synchronization.

1. Click the "TickTickSync" button in the ribbon menu.
2. Invoke the "TickTickSync: Synchronize" command from the command palette.
3. Assign a short cut key to the "TickTickSync: Synchronize" command from settings.

Click "Check Database" to check for possible synchronization errors.

Turn on for additional debug logging. Choose the debug level. Useful for troubleshooting. When Debug Node is turned on, you can select to skip backups on reload. Please use judiciously.

Click "Backup" to backup TickTick data, The backed-up files will be stored in the root directory of the Obsidian vault as CSV files compatible with TickTick's "Import Backup".

Note: TickTick limits backups to 4 backups a day through the API. Please use judiciously.

Please see Task Examples

Syntax	Description	Example
#ticktick	Tasks marked with #ticktick will be synced to TickTick. Tasks without the #ticktick tag, but are one line below a #ticktick task and indented will be treated as Task Items (See Example Below). If you have enabled Full vault sync in the settings, #ticktick will be added automatically to ALL Tasks. UnTagged Tasks are ignored. Please see Task Examples	- [ ] task #ticktick
📅YYYY-MM-DD	The date format is 📅YYYY-MM-DD, indicating the due date of a task.	- [ ] task content 📅2025-02-05 #ticktick Supports the following calendar emojis.📅📆🗓🗓️
#projectTag	New tasks will be added to the default project(For example, inbox .), and you can change the default project in the settings or use a tag with the same name to specify a particular project.	- [ ] taskA #ticktick will be added to inbox. - [ ] taskB #tag #testProject #ticktick will be added to testProject.
#tag	Note that all tags without a project of the same name are treated as normal tags	- [ ] task #tagA #tagB #tagC #ticktick
Priority	TickTick only has three priority levels. They are mapped as follows. TickTick Obsidian 0 null 0 '⏬' 1 '🔽' 3 '🔼' 5 '⏫' 5 '🔺'	- [ ] task ⏫ #ticktick

Task with Sub Tasks	Task with Items	Task ignored
Task with Sub Tasks #ticktick Sub Task 1 #ticktick Sub Task 2 #ticktick	Task with Items #ticktick Item 1 Item 2	This task will be ignored. It does not have a ticktick tag.

Notes are now synchronized automatically.

1. A Note starts on the line following its containing Task.
2. A Note is indented the same number of tabs as its containing task PLUS two spaces.
3. A Note has a separator line above and below the actual Note content.
4. If a Task has Task Items, Task Items will follow the Note.

The default project in the setting applies to all files. You can set a separate default project for each file using command.

You can see the current file's default project in the status bar at the bottom right corner.

Drag and drop the task between projects.

• If the target project is a project which is assigned to a default file the Task will end up in that file in your vault.
• If the target project is a project that is not assigned to a default file the Task will end up in the assigned default file.

Cut and Paste the task between files.

• If the target file has a default project, the task will be moved to the same project in TickTick
• If the target file does not have a default project, the task will be moved to the designated default project in TickTick
• If the target file does not have a default project, and not default project for TickTickSync is assigned, the task will be moved to the Inbox in TickTick

All Task hierarchy changes are reflected after a synchronization cycle.

If you set a default folder in TickTickSync, and it is NOT the Inbox, and you do not have a default file for the Inbox, tasks created in the Inbox will be moved to the default folder and file.

Date Handling has been updated to handle Times and to be Tasks plugin compatible. Complete details here.