Todoist Task to Markdown

Convert a Todoist task (and its comments) into a clean, readable Markdown format. Perfect for archiving tasks or migrating notes.

This tool was completely AI-generated. I didn't write any code, although I did use some fancy rules and a package starter template.

Installation

uv tool install todoist-to-md

Usage

1. Set your Todoist API token:

   You can find your API token in the Todoist Integrations settings.

   export TODOIST_API_KEY="your_api_token_here"
   

2. Run the tool with a Todoist task URL:

   todoist-to-md https://app.todoist.com/app/task/family-notes-6WHj3H6XmQ6F5HJJ
   

3. Save output to a file:

   todoist-to-md https://app.todoist.com/app/task/family-notes-6WHj3H6XmQ6F5HJJ --output task.md
   

Example Output

# Family Notes

**Original:** https://app.todoist.com/app/task/family-notes-6WHj3H6XmQ6F5HJJ
**Project:** Personal
**Section:** Planning

## Description

Review the family photos and provide feedback on composition and lighting.

## Comments

### 2025-06-13 10:30

Initial thoughts: The composition looks good but we need better lighting.

### 2025-06-14 15:45

Added some suggestions for the next photo session.

This project was created from iloveitaly/python-package-template