Limitations

Limitations

Conflating list bullets

Commonmark supports conflating list item bullets on a single line. Thus for instance the following two fragments produce a level-3 item:

Regular syntax:

*
    *
        * level 3

Conflated:

*    *   * level 3

The conflated version is useful when the levels that come before the level-3 item are empty. The intended output is a single line consisting of the level-3 list item, suppressing the lines of the empty, lower-numbered levels.

However, the mdview Viewer (and all its text output modes except --html) cannot suppress the empty levels. Thus, when viewed in mdview, the conflated bullet syntax produces three output lines, exactly like the regular syntax.

Regular syntax:

• • • level 3

Conflated:

• • • level 3

Lists and block quotes

The indentation of lists within block quote, and block quote within list, is often wrong.

Tables

Mdview does not apply auto-code spans inside table cells.

Mdview does not recognize pipes (|) inside code marks as cell boundaries. Arguably, this is a good thing; however cmark-gfm does the opposite.

Columns may be misaligned if:

• Some cells include wide characters, such as East Asian characters or larger emojis.

• Images (Mdview cannot compute image width in characters).

• ANSI or TTY escape codes (Mdview cannot compute column width in visible characters).

See also Table rendering limitations.