Skip to main content

Convert a Todoist task (and its comments) to a clean, readable markdown format from the command line.

Project description

Release Notes Downloads GitHub CI Status License: MIT

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

todoist_to_md-0.1.3.tar.gz (3.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

todoist_to_md-0.1.3-py3-none-any.whl (4.1 kB view details)

Uploaded Python 3

File details

Details for the file todoist_to_md-0.1.3.tar.gz.

File metadata

  • Download URL: todoist_to_md-0.1.3.tar.gz
  • Upload date:
  • Size: 3.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.10.4 {"installer":{"name":"uv","version":"0.10.4","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for todoist_to_md-0.1.3.tar.gz
Algorithm Hash digest
SHA256 50750ab0b7f53a62b5153b5ce9f842899de70af2c5e15866c6ad0bfd2d586705
MD5 0f3c35f7d7ba2519a5a9ace706868951
BLAKE2b-256 93c4e60b93d0040e77bc693492109b3a5b67567b03768afb9fb0d4cdb01a817e

See more details on using hashes here.

File details

Details for the file todoist_to_md-0.1.3-py3-none-any.whl.

File metadata

  • Download URL: todoist_to_md-0.1.3-py3-none-any.whl
  • Upload date:
  • Size: 4.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.10.4 {"installer":{"name":"uv","version":"0.10.4","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for todoist_to_md-0.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 94eba2213515cf1b83f50e113de8ea6e64d5338d4ce4c0bfd16afcbf1d6d6c64
MD5 1bb18c0c99e8b79a92ad6304e88ed211
BLAKE2b-256 b88082502461a3b2880c6813221275ce6a62209276b44b8c76b3931719b44162

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page