탐색

탐색 메뉴는 모든 웹사이트에 있는 링크 목록입니다.

새 페이지를 추가할 때마다 docs.json을 업데이트해야 합니다. 페이지는 자동으로 나타나지 않습니다.

탐색 구문

탐색 구문은 재귀적이므로 중첩된 탐색 그룹을 만들 수 있습니다. 페이지 이름에 .mdx를 포함할 필요가 없습니다.

"navigation": {
  "tabs": [
    {
      "tab": "Docs",
      "groups": [
        {
          "group": "Getting Started",
          "pages": ["quickstart"]
        }
      ]
    }
  ]
}

"navigation": {
  "tabs": [
    {
      "tab": "Docs",
      "groups": [
        {
          "group": "Getting Started",
          "pages": [
            "quickstart",
            {
              "group": "Nested Reference Pages",
              "pages": ["nested-reference-page"]
            }
          ]
        }
      ]
    }
  ]
}

폴더

MDX 파일을 폴더에 넣고 docs.json에서 경로를 업데이트하기만 하면 됩니다.

예를 들어 https://yoursite.com/your-folder/your-page에 페이지를 만들려면 your-page.mdx라는 MDX 파일이 포함된 your-folder라는 폴더를 만들면 됩니다.

경고

api를 폴더 이름으로 사용할 수 없으며 다른 폴더 안에 중첩하지 않는 한 사용할 수 없습니다. Mintlify는 내부 서버 호출을 위해 최상위 api 폴더를 예약하는 Next.js를 사용합니다. api-reference와 같은 폴더 이름은 허용됩니다.

"navigation": {
  "tabs": [
    {
      "tab": "Docs",
      "groups": [
        {
          "group": "Group Name",
          "pages": ["your-folder/your-page"]
        }
      ]
    }
  ]
}

숨겨진 페이지

docs.json에 포함되지 않은 MDX 파일은 사이드바에 나타나지 않지만 검색 표시줄과 직접 링크를 통해 접근할 수 있습니다.