DEPRECATED

Use https://github.com/hedgedoc/markdown-it-plugins instead

markdown-it-better-task-lists

This is a typescript port of markdown-it-task-lists markdown-it plugin for generating GitHub style task-lists.

What it does

• Builds task/todo lists out of markdown lists with items starting with [ ] or [x].
• Nothing else

Why is this useful?

When you have markdown documentation with checklists, rendering HTML checkboxes out of the list items looks nicer than the raw square brackets.

Usage

Use it the same as a normal markdown-it plugin:

1import MarkdownIt from 'markdown-it'
2import taskLists from '@hedgedoc/markdown-it-task-lists'
3
4const parser = new MarkdownIt().use(taskLists)
5
6const result = parser.render(`
7- [ ] Open task
8- [x] Done task
9- Not a task
10`) // markdown string containing task list items

The rendered checkboxes are disabled; to change this, set enabled property of the plugin options to true:

1const parser = new MarkdownIt().use(taskLists, { enabled: true })

If you need to know which line in the markdown document the generated checkbox comes set the lineNumber property of the plugin options to true for the <input> tag to be created with a data-line attribute containing the line number:

1const parser = new MarkdownIt().use(taskLists, { lineNumber: true })

If you'd like to wrap the rendered list items in a <label> element for UX purposes, set the label property of the plugin options to true:

1const parser = new MarkdownIt().use(taskLists, { label: true })

To add the label after the checkbox set the labelAfter property of the plugin options to true:

1const parser = new MarkdownIt().use(taskLists, { label: true, labelAfter: true })

Note: This option does require the label option to be truthy.

The options can be combined, of course.

Tests

1yarn install
2yarn test

License

ISC