Metadata-Version: 2.3
Name: todoist-to-md
Version: 0.2.0
Summary: Convert a Todoist task (and its comments) to a clean, readable markdown format from the command line.
Keywords: todoist,markdown,cli,export,tasks,comments,productivity
Author: Michael Bianco
Author-email: Michael Bianco <mike@mikebian.co>
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Dist: todoist-api-python
Requires-Dist: click
Requires-Dist: whenever
Requires-Python: >=3.11
Project-URL: Repository, https://github.com/iloveitaly/todoist-to-markdown
Description-Content-Type: text/markdown

[![Release Notes](https://img.shields.io/github/release/iloveitaly/todoist-to-markdown)](https://github.com/iloveitaly/todoist-to-markdown/releases)
[![Downloads](https://static.pepy.tech/badge/todoist-to-md/month)](https://pepy.tech/project/todoist-to-md)
![GitHub CI Status](https://github.com/iloveitaly/todoist-to-markdown/actions/workflows/build_and_publish.yml/badge.svg)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/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](https://github.com/iloveitaly/llm-ide-prompts) and a [package starter template](https://github.com/iloveitaly/python-package-template).

## Installation

```bash
uv tool install todoist-to-md
```

## Usage

1. **Set your Todoist API token:**

   You can find your API token in the [Todoist Integrations settings](https://todoist.com/app/settings/integrations).

   ```bash
   export TODOIST_API_KEY="your_api_token_here"
   ```

2. **Run the tool with a Todoist task URL:**

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

3. **Save output to a file:**

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

## Example Output

```markdown
# 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](https://github.com/iloveitaly/python-package-template)*
