{"repo":"rexgarland/markdown-plan","free":true,"listed":false,"github":"https://github.com/rexgarland/markdown-plan","clone":"git clone https://github.com/rexgarland/markdown-plan.git","description":"Project planning in markdown, as simple as possible","language":"Python","stars":71,"topics":["markdown","productivity","git","tasks","planner","visualization","markdown-based-project-management","project-management"],"license":"GPL-3.0","category":"productivity","readme_excerpt":"markdown-plan markdown-plan is a project planning syntax for markdown. Writing your plan in markdown offers some unique benefits: - Tracking it in version control - Plotting progress over time to calculate better ETAs - Documenting changes to the plan - Visualizing a plan (e.g. as a DAG of tasks) - Easily sharing a plan with others All of these things make planning more transparent and flexible to change. Syntax Any line formatted as a list item or header is a task. Everything else is ignored. A code block, also ignored. Tasks can be organized into hierarchical lists, ordered or unordered. A task can be marked as \"done\" with an [x] at the beginning: Tasks can also have explicit dependencies using the @(...) syntax, although this is rarely needed. Each dependency is a unique substring of the task it depends on. The substring cannot include commas. Parsing Any valid plan can be parsed into a tree or a DAG, depending on the user's needs. It is possible to create cyclic dependencies using the dependency notation above. A plan with cyclic dependencies is not a valid plan. Extensions The core syntax described above is as simple as possible by design. But it is useful to extend it, like add optional dates and time intervals to tasks. See the Gantt example below. Any \"extended\" syntax must still be parseable as a \"vanilla\" markdown plan, as specified by this document. Installing Usage This repo only ships with some basic CLI tools and a parsing library. See examples below for more so","default_branch":null,"files":null,"tree":[],"storefront":"/r/rexgarland","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/rexgarland/markdown-plan/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}