Additional features

Article last updated at August 11, 2026

Below are the markup elements that are not supported by default but can be enabled using markdown-it plugins.

For instructions on how to enable an additional plugin, see the guide.

Subscript

Plugin: markdown-it-sub

To render a character in subscript, wrap it with ~ on both sides.

H~2~O

You can vote for subscript support in YFM by default in GitHub issues.

Underlined text

Plugin: markdown-it-ins

To underline text, wrap it with ++ on both sides.

++qwerty++

You can vote for underlined text support in YFM by default in GitHub issues.

Footnotes

Plugin: markdown-it-footnote

Use footnotes when you need to provide additional information without complicating the text. Footnotes consist of two parts linked by labels:

  • a reference in the document text, displayed as a superscript;
  • a block of additional information. Usually placed at the end of the document.
Here's a simple footnote,[^1] and here's a longer one.[^bignote]

[^1]: This is the first footnote.

[^bignote]: Here's one with multiple paragraphs and code.

You can vote for footnote support in YFM by default in GitHub issues.

Task lists

A task list is a list of checkboxes. An unchecked item corresponds to the symbol - [ ] , and a checked one to - [x]. You can use inline formatting in the task description.

Example of enabling

You can vote for task list support in YFM by default in GitHub issues.

Formulas

Plugin: markdown-it-katex (see other versions)

The plugin uses the KaTeX library to render mathematical notation.

Example of enabling