🗺️ Be able to export a Taskfile to markdown documentation w. mermaid dependency graph 📝 #2503
Description
Description
❔ About
I use task a lot, and someimes, I feel the need to :
- ➿ Automate documentation (for example within a CI pipeline)
- 🗣️ Share a
taskfile to non-programmers to explain them a workflow I implemented withtask
👉 I only need to export a kind of javadoc or taskdoc
💡 The idea
In addition to --list option, would it possible to add the --markdown option so we could get that kind of md output :
Taskfile Workflow Diagram
This diagram visualizes the dependencies and flow between tasks defined in Taskfile.yml :
graph TD
default["**default**"]:::defaultNode -- deps --> generate["generate"]
default -- deps --> generate-webp["generate-webp"]
default -- deps --> optimize["optimize"]
generate -- deps --> setup["setup"]
clean["clean"]
pdf-logo["pdf-logo"]
classDef defaultNode fill:#1976D2,color:#fff,stroke:#333,stroke-width:2px;
Task Goals and Descriptions
| Task Name | Description |
|---|---|
| default | This Taskfile dynamically creates PNG and JPEG image assets from SVG source files. Run 'task generate' to create them. |
| setup | Check for required tools (svgexport, convert, optipng, jpegoptim) |
| generate | Generate PNG and JPEG versions of the logos from SVG files |
| clean | Remove all generated files |
| pdf-logo | Compile the LaTeX logo into a PDF and clean up auxiliary files |
| generate-webp | Generate WebP versions of the logos from PNG files |
| optimize | Optimize the size of generated PNG and JPEG files |
Copy and paste the Mermaid code into a Markdown viewer that supports Mermaid to see the graph rendered visually.
🔭 Further with dot / graphviz option
Like terraform makes it possible, maybe add the option to export to dot / graphviz