{"id":49585712,"url":"https://github.com/alharari01/markdown-to-trello-export","last_synced_at":"2026-05-03T22:34:18.391Z","repository":{"id":311012803,"uuid":"1042129339","full_name":"alharari01/markdown-to-trello-export","owner":"alharari01","description":"This script exports unchecked checklist items from a Markdown file generated from your project using Cursor to Trello cards. It allows for flexible grouping of cards into Trello lists based on Markdown headings.","archived":false,"fork":false,"pushed_at":"2025-08-21T14:41:52.000Z","size":17,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-12-24T03:58:07.031Z","etag":null,"topics":["api","cursor-ai","exporter","js","list","lists","markdown","nodejs","script","trello","trello-board","trello-card","unchecked"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alharari01.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-21T14:25:14.000Z","updated_at":"2025-08-24T09:46:09.000Z","dependencies_parsed_at":"2025-08-21T17:01:46.319Z","dependency_job_id":"bd61d39b-0f4f-460d-861a-a481d780abc1","html_url":"https://github.com/alharari01/markdown-to-trello-export","commit_stats":null,"previous_names":["abdupdf/markdown-to-trello-export","alharari01/markdown-to-trello-export"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/alharari01/markdown-to-trello-export","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alharari01%2Fmarkdown-to-trello-export","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alharari01%2Fmarkdown-to-trello-export/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alharari01%2Fmarkdown-to-trello-export/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alharari01%2Fmarkdown-to-trello-export/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alharari01","download_url":"https://codeload.github.com/alharari01/markdown-to-trello-export/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alharari01%2Fmarkdown-to-trello-export/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32587821,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-03T22:12:39.696Z","status":"ssl_error","status_checked_at":"2026-05-03T22:09:10.534Z","response_time":103,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","cursor-ai","exporter","js","list","lists","markdown","nodejs","script","trello","trello-board","trello-card","unchecked"],"created_at":"2026-05-03T22:34:17.792Z","updated_at":"2026-05-03T22:34:18.384Z","avatar_url":"https://github.com/alharari01.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Trello Export Script\n\nThis script exports unchecked checklist items from a Markdown file generated from your project using Cursor to Trello cards. It allows for flexible grouping of cards into Trello lists based on Markdown headings.\n\nhere's when to use it, when you're working on a porject in Cursor and you have generated a to-do list for your project in markdown, you might want to export that to-do to Trello for your team or customer to see your progress. this script helps you to do that in seconds.\nit's customizable and to add more features for your own needs just open the script in Cursor and tell it to add (feature 1) or tell it to run it. \n\n\u003e P.S if it's confusing just tell Cursor to run it based on your project. \n\n## Setup\n\n1.  **Obtain Trello API Key and Token:**\n    *   Go to [https://trello.com/app-key](https://trello.com/app-key).\n    *   Copy your **API Key**.\n    *   Click on \"Generate a new token\" to get your **API Token**.\n\n2.  **Get Trello Board ID:**\n    *   Navigate to your Trello board in your web browser.\n    *   The Board ID is part of the URL, e.g., `https://trello.com/b/\u003cBOARD_ID\u003e/your-board-name`.\n\n3.  **Set Environment Variables:**\n    Create a `.env` file in the root of your project or set these variables directly in your shell:\n\n    ```bash\n    TRELLO_KEY=\"your_trello_api_key\"\n    TRELLO_TOKEN=\"your_trello_api_token\"\n    TRELLO_BOARD_ID=\"your_trello_board_id\"\n    ```\n\n## Usage\n\nNavigate to the script directory in your terminal:\n\n```bash\ncd scripts/export-trello\n```\n\nRun the script:\n\n```bash\nnode export-trello.js\n```\n\n### Options (Environment Variables)\n\nYou can customize the script's behavior by setting these optional environment variables:\n\n*   `TRELLO_LIST_ID`: (Optional) If provided, all cards will be exported to this specific Trello list. This overrides the grouping behavior.\n    ```bash\n    TRELLO_LIST_ID=\"your_existing_list_id\" node export-trello.js\n    ```\n*   `TRELLO_LIST_NAME`: (Optional) The name for a new Trello list if `TRELLO_LIST_ID` is set. Default is `Markdown Export YYYY-MM-DD`.\n    ```bash\n    TRELLO_LIST_NAME=\"My Custom List\" TRELLO_LIST_ID=\"...\" node export-trello.js\n    ```\n*   `EXCLUDE_COMPLETED`: Set to `1` to skip checklist items marked as completed (`- [x]`). Default is `0` (include all).\n    ```bash\n    EXCLUDE_COMPLETED=1 node export-trello.js\n    ```\n*   `INCLUDE_TOPLEVEL`: Set to `1` to include top-level checklist items (tasks without indentation). Default is `0` (skip top-level).\n    ```bash\n    INCLUDE_TOPLEVEL=1 node export-trello.js\n    ```\n*   `GROUP_BY`: Determines how Trello lists are created based on Markdown headings. Can be `h4`, `h3`, or `h2`. Default is `h4` (falls back to `h3` then `h2` if `h4` is not present).\n    ```bash\n    GROUP_BY=h3 node export-trello.js\n    ```\n\n## Markdown Checklist Format\n\nThe script expects checklist items in the format:\n\n```markdown\n- [ ] My unchecked task\n  - [x] My completed sub-task (will be skipped if EXCLUDE_COMPLETED=1)\n- [ ] Another task\n```\n\nHeadings are used for grouping:\n\n```markdown\n## Major Section\n### Sub-Section A\n#### Detail Group 1\n- [ ] Task 1.1\n- [ ] Task 1.2\n\n#### Detail Group 2\n- [ ] Task 2.1\n\n### Sub-Section B\n- [ ] Task 3.1\n```\n\nIn this example, if `GROUP_BY=h4`, tasks will go to \"Detail Group 1\" and \"Detail Group 2\" lists. If `GROUP_BY=h3`, tasks will go to \"Sub-Section A\" and \"Sub-Section B\" lists.\n\n\n\n## 🔗 Links\n[![twitter](https://img.shields.io/badge/twitter-1DA1F2?style=for-the-badge\u0026logo=twitter\u0026logoColor=white)](https://x.com/alharari01)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falharari01%2Fmarkdown-to-trello-export","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falharari01%2Fmarkdown-to-trello-export","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falharari01%2Fmarkdown-to-trello-export/lists"}