Auto-generated GraphQL docs indent sections beyond h6

Everyone can contribute. Help move this issue forward while earning points, leveling up and collecting rewards.

  • Close this issue

When GraphQL reference is generated (script | template), some sections are nested too deep, beyond six levels - there's no heading 7.

For example:

Raw Markdown In GitLab Markdown preview In rendered documentation
####### Arguments ####### Arguments # Arguments (as heading 6)
  • Generated docs page: https://docs.gitlab.com/api/graphql/reference/
  • Source: https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/api/graphql/reference/_index.md?plain=1

The following discussion from !79327 (merged) should be addressed:

  • @msedlakjakubowski started a discussion: (+1 comment)

    Hmmm, I need to check how this renders on the doc 🤔 There's no heading 7:

    # h1
    
    ## h2
    
    ### h3
    
    #### h4
    
    ##### h5
    
    ###### h6
    
    ####### h7?

    image

Edited Jul 29, 2025 by 🤖 GitLab Bot 🤖
Assignee Loading
Time tracking Loading