{"id":18265451,"url":"https://github.com/goodbyteco/markdown-tasks","last_synced_at":"2026-04-26T23:31:11.740Z","repository":{"id":96742914,"uuid":"286920819","full_name":"GoodbyteCo/Markdown-Tasks","owner":"GoodbyteCo","description":"A Markdown syntax for rich todo-items.","archived":false,"fork":false,"pushed_at":"2021-06-14T21:07:40.000Z","size":32,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-09T01:43:18.981Z","etag":null,"topics":["document","markdown","parser","specification","tasks","todolist"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-2-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/GoodbyteCo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2020-08-12T05:01:20.000Z","updated_at":"2023-07-17T04:59:53.000Z","dependencies_parsed_at":null,"dependency_job_id":"aab0fde0-ca6b-4435-ae9a-26be5e67352e","html_url":"https://github.com/GoodbyteCo/Markdown-Tasks","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/GoodbyteCo/Markdown-Tasks","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GoodbyteCo%2FMarkdown-Tasks","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GoodbyteCo%2FMarkdown-Tasks/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GoodbyteCo%2FMarkdown-Tasks/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GoodbyteCo%2FMarkdown-Tasks/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GoodbyteCo","download_url":"https://codeload.github.com/GoodbyteCo/Markdown-Tasks/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GoodbyteCo%2FMarkdown-Tasks/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32317162,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-26T23:26:28.701Z","status":"ssl_error","status_checked_at":"2026-04-26T23:26:25.802Z","response_time":129,"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":["document","markdown","parser","specification","tasks","todolist"],"created_at":"2024-11-05T11:18:14.609Z","updated_at":"2026-04-26T23:31:11.723Z","avatar_url":"https://github.com/GoodbyteCo.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Markdown Tasks\n\nThis document is a syntax for todo-lists in Markdown. It proposes a standard that integrates task date, time, and importance. Like [Gruber's original spec](https://daringfireball.net/projects/markdown/), this syntax aims to be readable as-is.\n\u003e a Markdown-formatted document should be publishable as-is, as plain text, without looking like it’s been marked up with tags or formatting instructions.\n\n\u003cbr\u003e\n\n- [Structure](#structure)\n  - [The Checkbox](#the-checkbox)\n  - [Text](#text)\n  - [Importance](#importance)\n  - [Timing](#timing)\n  - [Date](#date)\n- [Examples](#examples)\n- [In Use](#in-use)\n\n\u003cbr\u003e\n\n## Structure\n\nA todo-item, like a Markdown list-item, should take up one line. They begin with a hyphen `-` (so that they render as list-items in standard Markdown), followed by the [checkbox](https://github.com/qjack001/Markdown-Tasks#the-checkbox), followed by a space. Everything else (text, importance, time, and date) is optional, and can occur in any order—except for the date, which must come last.\n\n```\n- \u003ccheckbox\u003e [\u003ctext\u003e, \u003cimportance\u003e, \u003ctime\u003e, \u003cdate\u003e]\n```\n\nThe checkbox is most often written as two square-brackets with a space in-between `[ ]` (see [the checkbox syntax](https://github.com/qjack001/Markdown-Tasks#the-checkbox) for all options). [Importance](https://github.com/qjack001/Markdown-Tasks#importance) is denoted as a series of exclamation points `!`, from none (least urgent) to three (most urgent). [Timing](https://github.com/qjack001/Markdown-Tasks#timing), which references what time the item occurs or needs to occur by (**not** the duration of the item), is denoted with the at-symbol `@`. The [date](https://github.com/qjack001/Markdown-Tasks#date) should be formatted as `YYYY-MM-DD`, and wrapped in parentheses `(...)`.\n\n```\n- [ ] Example todo item !! @8pm (2020-08-11)\n```\n\n### The Checkbox\n\nAn empty checkbox is written as: `[ ]`. This should produce an `\u003cinput type=\"checkbox\"\u003e` element.\n```\n- [ ] Unfinished todo\n```\nTasks that have been pulled from previous times can be written as: `-\u003e]`, but should still produce an `\u003cinput type=\"checkbox\"\u003e` element.\n```\n- -\u003e] Task from last week\n```\nTasks that have been pushed to later are written as: `[-\u003e`, and create an `\u003cinput type=\"checkbox\" disabled\u003e` element.\nA completed task has a checked checkbox, and is written as: `[*]`. This produces an `\u003cinput type=\"checkbox\" checked\u003e`.\n```\n- [*] Completed todo\n```\nYou can also use `-`, `+`, `x`, `v`, `•`, `@`, `#`, `√`, `~`, or `✓` to mark a box as checked.\n```\n- [x] This is fine\n- [#] This is also fine\n- [✓] All good over here\n- [@] Everything is done\n```\n\n### Text\n\nThe text of a todo-item can contain inline Markdown formatting (**bold**, *italic*, [links](https://itty.bitty.site/#a.html/data:text/html;charset=utf-8;bxze64,XQAAAAIBAQAAAAAAAAAeCEUG0O+oKBdZ2an16qclPsVsLFhs2pzAN35/bHmc6Ddvq8IM4lbOVrZC5BW5l5dG325bCokrtxIjlYLBkr75n38PgebbjPKZcMZMotzv8FTXMx24PkQix6dfYYbsceNOzuogCV3U9EM/hoEJecoR5JILpdVhnqsFU0CH7kUqAL/rRZ0M+rIMqPgkg90WZTXTvAzvh2xq8/wt4efihibwnWzBfQLw5Q+S7K+g+Re4o9bUmdX1eM3wwH1WXf/wsQjA), `code`).\n```\n- [ ] Get this one done *now*\n```\n\n### Importance\n\nThe urgency of a task can be set at one of four levels: none, low, medium, and high. This is written as zero, one, two, or three exclamation points in a row, respectively. The exclamation points can come before or after the text (but not within the text), and a separating space is optional.\n```\n- [ ] Very important!!\n- [ ] Even more important !!!\n- [ ] !A little important\n- [*] Not at all important\n```\n\n### Timing\n\nSometimes tasks need to happen at a certain time (like meetings), or before a certain time (like schoolwork). The time a task occurs at can be set by writing an at-symbol `@` followed by the time (no spaces). The time can be written with or without minutes, and with or without the \"AM/PM\" (note that if there is no AM or PM, 24-hour time is assumed).\n\n```\n- [ ] This task occurs @8pm\n- [ ] @6:30am Walk the dog\n- [ ] You can do uppercase @10:30PM\n- [ ] Or 24-hour @18:00\n```\n\n### Date\n\nThe date the task is due can be added at the end. It must follow `(YYYY-MM-DD)` format.\n\n```\n- [ ] Happy new year (2025-01-01)\n- [*] Eat 100 hotdogs (2006-06-25)\n```\n\n## Examples\n\nHere are a handful of examples of correct Markdown task items:\n\n```\n- [*] Check out the new Jack White album (2018-03-23)\n- [ ] Put out fire!!! @8AM\n- -\u003e] Buy new extinguisher\n- [ ] Meet Marty for dinner @6:30pm (2020-08-12)\n- [-\u003e Do something later\n```\n\n## In Use\n\n- [todo: a tiny command-line todo-list app](https://github.com/qjack001/todo)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgoodbyteco%2Fmarkdown-tasks","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgoodbyteco%2Fmarkdown-tasks","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgoodbyteco%2Fmarkdown-tasks/lists"}