GitHub Flavored Markdown is getting a little Task List flavoring.
Markdown is a way of formatting text and inserting images. It can be used with the following features of Habitica: Titles, notes, and checklists for tasks and Rewards (including tasks and Rewards for Challenges and Group Plans) Titles, summaries, and descriptions of Guilds, Parties, and Challenges. Unordered lists start with a. Begin each list item on a new line. In a Markdown file or widget, enter two spaces before the line break to begin a new paragraph, or enter two line breaks consecutively to begin a new paragraph. Ordered or numbered lists. Task lists allow you to create a list of items with checkboxes. In Markdown applications that support task lists, checkboxes will be displayed next to the content. To create a task list, add dashes (-) and brackets with a space ( ) in front of task list items. To select a checkbox, add an x in between the brackets (x).
Today, we’re shipping an enhancement to our Markdown pipeline to support task lists. Task lists are lists with items marked as either [ ] or [x] (incomplete or complete). For example:
This renders as a list of checkboxes. If you can modify the Markdown text, you can check or uncheck the boxes and the text will automatically update.
You can use task lists to break down large issues and discourage the creation of many microscopic issues, allowing you to focus on interacting with the list instead of editing Markdown.
The overriding design goal for Markdown’s formatting syntax is to make it as readable as possible. The idea is that 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.
(source)
We chose this syntax to stay true to Markdown’s principle of being easy to read in plain text. It is already in common use and appealing without having to be rendered.
Oh, and one more thing:
Markdown Checklist Jira
Issues and pull requests with task list items defined will summarize the task list on the pull request listing and any cross reference.