Skip to main content
사전 요구 사항: 계속하기 전에 Node.js(버전 19 이상)를 설치하세요.
계속하기 전에 docs.json으로 전환하고 기존 mint.json 파일을 삭제하세요.
운영 체제에서 Mintlify를 설치하고 실행하려면 다음 단계를 따르세요. 1단계: Mintlify 설치: 
npm i -g mintlify
2단계: docs.json 파일이 있는 docs 디렉터리로 이동한 다음, 다음 명령어를 실행합니다: 
mintlify dev
문서의 로컬 미리보기는 http://localhost:3000에서 확인할 수 있습니다.

​
사용자 지정 포트

기본적으로 Mintlify는 포트 3000을 사용합니다. --port 플래그를 사용하면 Mintlify가 실행될 포트를 사용자 지정할 수 있습니다. 예를 들어 Mintlify를 포트 3333에서 실행하려면 다음 명령어를 사용합니다: 
mintlify dev --port 3333
이미 사용 중인 포트로 Mintlify를 실행하려고 하면, 다음으로 사용할 수 있는 포트를 사용합니다: 
Port 3000 is already in use. Trying 3001 instead.

​
Mintlify 버전

각 CLI 릴리스는 특정 Mintlify 버전에 연결됩니다. 로컬 웹사이트가 프로덕션 버전과 일치하지 않으면 CLI를 업데이트하세요. 
npm i -g mintlify@latest
CLI는 문서에 포함된 레퍼런스 링크를 검증하는 데 도움이 됩니다. 깨진 링크를 파악하려면 다음 명령어를 사용하세요: 
mintlify broken-links

​
배포

Pro 플랜 이상에서는 편집자를 무제한으로 이용할 수 있습니다.
배포가 성공하면 모든 검사를 통과했음을 알리는 확인 메시지가 표시됩니다.

​
코드 서식 지정

IDE에서 MDX를 인식하고 서식을 지정할 수 있도록 확장 프로그램 사용을 권장합니다. VSCode를 사용 중이라면 구문 강조 표시용으로 MDX VSCode extension을, 코드 서식 지정용으로 Prettier를 고려해 보세요.

​
문제 해결

이는 Node 버전이 오래되어 발생할 수 있습니다. 다음을 사용해 보세요:
  1. 현재 설치된 mintlify 버전을 제거합니다: npm remove -g mintlify
  2. Node를 v19 이상으로 업그레이드합니다.
  3. mintlify를 다시 설치합니다: npm install -g mintlify
해결 방법: 기기의 루트 디렉터리로 이동해 ~/.mintlify 폴더를 삭제합니다. 그런 다음 mintlify dev를 다시 실행합니다.
CLI 버전에서 무엇이 변경되었는지 궁금하신가요? CLI 변경 로그를 확인하세요.