Skip to content

[TOC maxLevel=2] is rendered as plain text instead of generating a table of contents #431

@tsungjung411

Description

@tsungjung411

Is this a hackmd.io issue?

Read our Official tutorial

It's on https://hackmd.io/c/tutorials/

or Chinese version: https://hackmd.io/c/tutorials-tw/

What's the problem

Current behaviour

[TOC] works, but [TOC maxLevel=2] is rendered as plain text and does not generate a table of contents.

Image Image

Reproducible content:

[TOC maxLevel=2]

### Section
- ### Case1
- ### Case2
- ### Case3

Actual rendered result:

[TOC maxLevel=2]

It is displayed as plain text instead of being parsed as TOC syntax.

Provide steps to reproduce:

  1. Go to https://hackmd.io

  2. Create a new note

  3. Paste the content below:

    [TOC maxLevel=2]
    
    ### Section
    - ### Case1
    - ### Case2
    - ### Case3
  4. Switch to preview / rendered view

  5. Observe that [TOC maxLevel=2] is shown as plain text

Here is an example: https://hackmd.io/AkRF_wKqQWqpo_MJ32Veww

Expected behaviour

[TOC maxLevel=2] should be recognized as valid TOC syntax and generate a table of contents, instead of being rendered as plain text.

Environment

I use HackMD on:

Desktop

  • OS: Windows / Ubuntu 24.04 / Android 14
  • Browser: Chrome 147.0.7727.56 , FireFox 143.0(64 位元)

Mobile

  • Device: Xiaomi Pro 13
  • OS: Android 14
  • Browser: Chrome 146.0.7880.177

Additional context

The official tutorial documents [TOC maxLevel=1] as supported syntax, so this behavior appears inconsistent with the documentation.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions