tasks(1)

NAME
tasks - manage tasks lists

SYNOPSIS
tasks [options] markdown-file ...

DESCRIPTION
tasks extracts tasks from markdown lists and outputs them as either markdown or HTML snippets. Optionally, extracted tasks may be removed from the source document.

Tasks may be grouped hierarchically, with a primary task containing subtasks, which may themselves contain subtasks. There is no inherent limit on how deeply tasks may be nested. A task group is only considered fully complete when the primary task and all nested subtasks are completed. Otherwise, the task group is partially complete.

OPTIONS

-b, --blank
    Include a blank line before any output. The line is omitted if there is no output.

-c, --completed
    Select only fully completed tasks for output.

-f FORMAT, --format=FORMAT
    Select format for output: markdown, html, or none.

-m MESSAGE, --message=MESSAGE
    Message to include before any output. The message is omitted if there is no output. The message is output as-is; no entity encoding is performed in HTML format mode.

-o OUTPUT, --output=OUTPUT
    Write output to the specified file instead of standard out.

-r, --remove-status
    When rendering markdown, remove completion statuses and produce plain bulleted lists.

-s, --strip
    Remove fully completed tasks from the input file.

EXIT STATUS
0 on success, non-0 on error.

NOTES
tasks.py reads and writes only UTF-8, because it's no longer the bad old days.

SEE ALSO
queue2ics(1)

AUTHOR
Perette Barella <perette@deviousfish.com>