From 4b3694fb05491add76485a2ec6df2a132b35367b Mon Sep 17 00:00:00 2001 From: "mintlify-development[bot]" <109878554+mintlify-development[bot]@users.noreply.github.com> Date: Mon, 20 Jul 2026 15:58:53 +0000 Subject: [PATCH 01/12] Updated mintlify pages - Updated zh/cli/install.mdx - Updated index.mdx Mintlify-Source: dashboard-editor --- index.mdx | 38 ++++++++++---------------------------- zh/cli/install.mdx | 44 ++++++++++++++++++++++++++------------------ 2 files changed, 36 insertions(+), 46 deletions(-) diff --git a/index.mdx b/index.mdx index a1efde0bac..9100bcf9a5 100644 --- a/index.mdx +++ b/index.mdx @@ -31,16 +31,9 @@ export const HeroCard = ({ filename, title, description, href }) => {
- Decorative background image. - Decorative background image. + Decorative background image. + + Decorative background image.
@@ -55,26 +48,15 @@ export const HeroCard = ({ filename, title, description, href }) => {
- + - + - +
+ +hello + +hello \ No newline at end of file diff --git a/zh/cli/install.mdx b/zh/cli/install.mdx index effe1b7bb1..78a5934f75 100644 --- a/zh/cli/install.mdx +++ b/zh/cli/install.mdx @@ -8,20 +8,22 @@ keywords: ["CLI", "npm", "安装", "Node.js", "pnpm", "mint"] ## 前提条件 -- [Node.js](https://nodejs.org/en) v20.17.0+（推荐 LTS 版本） +- [Node.js](https://nodejs.org/en) v20.17.0\+（推荐 LTSa 版本）
## 安装 CLI
- ```bash npm - npm i -g mint - ``` - ```bash pnpm - pnpm add -g mint - ``` +```bash npm +npm i -g mint +``` + +```bash pnpm +pnpm add -g mint +``` +
@@ -76,13 +78,15 @@ mint update 如果你的版本中没有 `mint update`，请使用最新版本重新安装 CLI： - ```bash npm - npm i -g mint@latest - ``` - ```bash pnpm - pnpm add -g mint@latest - ``` +```bash npm +npm i -g mint@latest +``` + +```bash pnpm +pnpm add -g mint@latest +``` +
@@ -103,22 +107,26 @@ mint update 这可能是由于 Node.js 版本过旧导致的。请尝试以下步骤： 1. 卸载当前版本的 mint CLI：`npm uninstall -g mint` - 2. 升级到 Node.js v20.17.0+。 + 2. 升级到 Node.js v20.17.0\+。 3. 重新安装 mint CLI：`npm install -g mint` + **解决方案**：前往设备根目录，删除 `~/.mintlify` 文件夹。然后重新运行 `mint dev`。 + 这是因为你没有全局安装 Node 包所需的权限。 **解决方案**：尝试运行 `sudo npm i -g mint`。当提示时，输入你用于解锁电脑的密码。 + 这可能是由于 CLI 版本过旧导致的。 **解决方案**：运行 `mint update` 获取最新更改。 + 如果你遇到 CLI 包的问题，首先运行 `npm ls -g` 查看全局安装了哪些包。如果你不使用 npm，请尝试 `which mint` 来定位安装位置。 @@ -130,15 +138,15 @@ mint update npm i -g mint ``` + 如果运行 `mint version` 后客户端版本显示为 `none`，可能是 CLI 因企业防火墙或 VPN 而无法下载客户端应用程序。 **解决方案**：请你的 IT 管理员将 `releases.mintlify.com` 添加到网络允许列表中。 + - 在 `4.0.1125` 之前的版本中，从文档仓库运行 `npx mint dev` 或其他命令时，CLI 可能会 - 将自身错误地识别为本地开发构建。这会导致 CLI 指向 `localhost` URL 而不是 Mintlify - 生产 API，从而引发连接错误或意外行为。 + 在 `4.0.1125` 之前的版本中，从文档仓库运行 `npx mint dev` 或其他命令时，CLI 可能会 将自身错误地识别为本地开发构建。这会导致 CLI 指向 `localhost` URL 而不是 Mintlify 生产 API，从而引发连接错误或意外行为。 **解决方案**：更新到最新的 CLI 版本： @@ -146,4 +154,4 @@ mint update npm i -g mint@latest ``` - + \ No newline at end of file From 53a860ce155149a787bdcec6d84e8536ecec945b Mon Sep 17 00:00:00 2001 From: "mintlify-development[bot]" <109878554+mintlify-development[bot]@users.noreply.github.com> Date: Tue, 28 Jul 2026 18:20:01 +0000 Subject: [PATCH 02/12] Updated mintlify pages - Updated quickstart.mdx Mintlify-Source: dashboard-editor --- quickstart.mdx | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/quickstart.mdx b/quickstart.mdx index 4fc7601ca7..0291cdc013 100644 --- a/quickstart.mdx +++ b/quickstart.mdx @@ -1,10 +1,12 @@ --- -title: "Quickstart" +title: "Quickstart is another one" description: "Get started with Mintlify by deploying your documentation site in minutes and making your first content change with the web editor or Git." keywords: ["quickstart", "deploy", "get started", "first steps", "tutorial", "setup", "onboarding"] boost: 3 --- +jjnnfwaefawefawefeawf waef awefaew + import SkillMcpPrompt from "/snippets/skill-mcp-prompt.mdx"; After you complete this guide, you'll have a live documentation site ready to customize and update. From 32960f876262ac76ca8f4072d2315779b312a999 Mon Sep 17 00:00:00 2001 From: "mintlify-development[bot]" <109878554+mintlify-development[bot]@users.noreply.github.com> Date: Tue, 28 Jul 2026 18:20:50 +0000 Subject: [PATCH 03/12] Updated mintlify pages - Updated quickstart.mdx Mintlify-Source: dashboard-editor --- quickstart.mdx | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/quickstart.mdx b/quickstart.mdx index 0291cdc013..9ce4d8ddac 100644 --- a/quickstart.mdx +++ b/quickstart.mdx @@ -5,7 +5,9 @@ keywords: ["quickstart", "deploy", "get started", "first steps", "tutorial", "se boost: 3 --- -jjnnfwaefawefawefeawf waef awefaew +jjnnfwaefawefawefeawf waef awefaew fafaewfeawfewafwaefawe + +fawefaewfaew import SkillMcpPrompt from "/snippets/skill-mcp-prompt.mdx"; From c76d7673d99d51795953da1ec02a08e34d5b361c Mon Sep 17 00:00:00 2001 From: "mintlify-development[bot]" <109878554+mintlify-development[bot]@users.noreply.github.com> Date: Tue, 28 Jul 2026 18:33:02 +0000 Subject: [PATCH 04/12] Updated mintlify pages - Updated quickstart.mdx Mintlify-Source: dashboard-editor --- quickstart.mdx | 2 -- 1 file changed, 2 deletions(-) diff --git a/quickstart.mdx b/quickstart.mdx index 9ce4d8ddac..3b75fe4a96 100644 --- a/quickstart.mdx +++ b/quickstart.mdx @@ -7,8 +7,6 @@ boost: 3 jjnnfwaefawefawefeawf waef awefaew fafaewfeawfewafwaefawe -fawefaewfaew - import SkillMcpPrompt from "/snippets/skill-mcp-prompt.mdx"; After you complete this guide, you'll have a live documentation site ready to customize and update. From 2fa4d72e14105cb706e66d9ced37241bc37a5b33 Mon Sep 17 00:00:00 2001 From: "mintlify-development[bot]" <109878554+mintlify-development[bot]@users.noreply.github.com> Date: Tue, 28 Jul 2026 18:41:07 +0000 Subject: [PATCH 05/12] Updated mintlify pages - Updated quickstart.mdx Mintlify-Source: dashboard-editor --- quickstart.mdx | 6 ------ 1 file changed, 6 deletions(-) diff --git a/quickstart.mdx b/quickstart.mdx index 3b75fe4a96..1a950fc14c 100644 --- a/quickstart.mdx +++ b/quickstart.mdx @@ -5,12 +5,6 @@ keywords: ["quickstart", "deploy", "get started", "first steps", "tutorial", "se boost: 3 --- -jjnnfwaefawefawefeawf waef awefaew fafaewfeawfewafwaefawe - -import SkillMcpPrompt from "/snippets/skill-mcp-prompt.mdx"; - -After you complete this guide, you'll have a live documentation site ready to customize and update. - ## Before you begin Mintlify uses a docs-as-code approach to manage your documentation. Every page on your site has a corresponding file stored in your documentation repository. From 56d64c561dc65915fd0ab907d3ea86c62332f560 Mon Sep 17 00:00:00 2001 From: "mintlify-development[bot]" <109878554+mintlify-development[bot]@users.noreply.github.com> Date: Wed, 29 Jul 2026 00:39:09 +0000 Subject: [PATCH 06/12] Updated mintlify pages - Updated index.mdx - Updated zh/cli/install.mdx Mintlify-Source: dashboard-editor --- index.mdx | 38 ++++++++++++++++++++++++++++---------- zh/cli/install.mdx | 44 ++++++++++++++++++-------------------------- 2 files changed, 46 insertions(+), 36 deletions(-) diff --git a/index.mdx b/index.mdx index 9100bcf9a5..a1efde0bac 100644 --- a/index.mdx +++ b/index.mdx @@ -31,9 +31,16 @@ export const HeroCard = ({ filename, title, description, href }) => {
- Decorative background image. - - Decorative background image. + Decorative background image. + Decorative background image.
@@ -48,15 +55,26 @@ export const HeroCard = ({ filename, title, description, href }) => {
- + - + - +
- -hello - -hello \ No newline at end of file diff --git a/zh/cli/install.mdx b/zh/cli/install.mdx index 78a5934f75..effe1b7bb1 100644 --- a/zh/cli/install.mdx +++ b/zh/cli/install.mdx @@ -8,22 +8,20 @@ keywords: ["CLI", "npm", "安装", "Node.js", "pnpm", "mint"] ## 前提条件
-- [Node.js](https://nodejs.org/en) v20.17.0\+（推荐 LTSa 版本） +- [Node.js](https://nodejs.org/en) v20.17.0+（推荐 LTS 版本）
## 安装 CLI
+ ```bash npm + npm i -g mint + ``` -```bash npm -npm i -g mint -``` - -```bash pnpm -pnpm add -g mint -``` - + ```bash pnpm + pnpm add -g mint + ```
@@ -78,15 +76,13 @@ mint update 如果你的版本中没有 `mint update`，请使用最新版本重新安装 CLI： + ```bash npm + npm i -g mint@latest + ``` -```bash npm -npm i -g mint@latest -``` - -```bash pnpm -pnpm add -g mint@latest -``` - + ```bash pnpm + pnpm add -g mint@latest + ```
@@ -107,26 +103,22 @@ pnpm add -g mint@latest 这可能是由于 Node.js 版本过旧导致的。请尝试以下步骤： 1. 卸载当前版本的 mint CLI：`npm uninstall -g mint` - 2. 升级到 Node.js v20.17.0\+。 + 2. 升级到 Node.js v20.17.0+。 3. 重新安装 mint CLI：`npm install -g mint` - **解决方案**：前往设备根目录，删除 `~/.mintlify` 文件夹。然后重新运行 `mint dev`。 - 这是因为你没有全局安装 Node 包所需的权限。 **解决方案**：尝试运行 `sudo npm i -g mint`。当提示时，输入你用于解锁电脑的密码。 - 这可能是由于 CLI 版本过旧导致的。 **解决方案**：运行 `mint update` 获取最新更改。 - 如果你遇到 CLI 包的问题，首先运行 `npm ls -g` 查看全局安装了哪些包。如果你不使用 npm，请尝试 `which mint` 来定位安装位置。 @@ -138,15 +130,15 @@ pnpm add -g mint@latest npm i -g mint ``` - 如果运行 `mint version` 后客户端版本显示为 `none`，可能是 CLI 因企业防火墙或 VPN 而无法下载客户端应用程序。 **解决方案**：请你的 IT 管理员将 `releases.mintlify.com` 添加到网络允许列表中。 - - 在 `4.0.1125` 之前的版本中，从文档仓库运行 `npx mint dev` 或其他命令时，CLI 可能会 将自身错误地识别为本地开发构建。这会导致 CLI 指向 `localhost` URL 而不是 Mintlify 生产 API，从而引发连接错误或意外行为。 + 在 `4.0.1125` 之前的版本中，从文档仓库运行 `npx mint dev` 或其他命令时，CLI 可能会 + 将自身错误地识别为本地开发构建。这会导致 CLI 指向 `localhost` URL 而不是 Mintlify + 生产 API，从而引发连接错误或意外行为。 **解决方案**：更新到最新的 CLI 版本： @@ -154,4 +146,4 @@ pnpm add -g mint@latest npm i -g mint@latest ``` - \ No newline at end of file + From adec5c11548246bf7d32cd8e9b51d59ba8789936 Mon Sep 17 00:00:00 2001 From: "mintlify-development[bot]" <109878554+mintlify-development[bot]@users.noreply.github.com> Date: Wed, 29 Jul 2026 00:39:27 +0000 Subject: [PATCH 07/12] Updated mintlify pages - Updated quickstart.mdx Mintlify-Source: dashboard-editor --- quickstart.mdx | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/quickstart.mdx b/quickstart.mdx index 1a950fc14c..331b596ea2 100644 --- a/quickstart.mdx +++ b/quickstart.mdx @@ -5,10 +5,16 @@ keywords: ["quickstart", "deploy", "get started", "first steps", "tutorial", "se boost: 3 --- +import SkillMcpPrompt from "/snippets/skill-mcp-prompt.mdx"; + +After you complete this guide, you'll have a live documentation site ready to customize and update. + ## Before you begin Mintlify uses a docs-as-code approach to manage your documentation. Every page on your site has a corresponding file stored in your documentation repository. +fewafaewf + When you connect your documentation repository to your project, you can work on your documentation locally or in the web editor and sync any changes to your remote repository. From ed4e13c7ed9651c50b23a6c0a851e0f7474560b0 Mon Sep 17 00:00:00 2001 From: "mintlify-development[bot]" <109878554+mintlify-development[bot]@users.noreply.github.com> Date: Wed, 29 Jul 2026 00:49:56 +0000 Subject: [PATCH 08/12] Updated mintlify pages - Updated quickstart.mdx Mintlify-Source: dashboard-editor --- quickstart.mdx | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/quickstart.mdx b/quickstart.mdx index 331b596ea2..4fc7601ca7 100644 --- a/quickstart.mdx +++ b/quickstart.mdx @@ -1,5 +1,5 @@ --- -title: "Quickstart is another one" +title: "Quickstart" description: "Get started with Mintlify by deploying your documentation site in minutes and making your first content change with the web editor or Git." keywords: ["quickstart", "deploy", "get started", "first steps", "tutorial", "setup", "onboarding"] boost: 3 @@ -13,8 +13,6 @@ After you complete this guide, you'll have a live documentation site ready to cu Mintlify uses a docs-as-code approach to manage your documentation. Every page on your site has a corresponding file stored in your documentation repository. -fewafaewf - When you connect your documentation repository to your project, you can work on your documentation locally or in the web editor and sync any changes to your remote repository. From abcc2a1138dce3e766258334849f53400a54d161 Mon Sep 17 00:00:00 2001 From: "mintlify-development[bot]" <109878554+mintlify-development[bot]@users.noreply.github.com> Date: Wed, 29 Jul 2026 00:51:14 +0000 Subject: [PATCH 09/12] Updated mintlify pages - Updated editor/branching-and-publishing.mdx Mintlify-Source: dashboard-editor --- editor/branching-and-publishing.mdx | 2 ++ 1 file changed, 2 insertions(+) diff --git a/editor/branching-and-publishing.mdx b/editor/branching-and-publishing.mdx index c7d3e0710b..8eb7a08186 100644 --- a/editor/branching-and-publishing.mdx +++ b/editor/branching-and-publishing.mdx @@ -8,6 +8,8 @@ The web editor autosaves everything as you type, but your changes are only live What happens when you publish depends on two things: **which branch you're on** and **whether that branch requires pull requests**. +faewfaew + ## Saving versus publishing **Saving** happens automatically. Mintlify stores your edits on its servers and persists them across browser tabs, devices, and network interruptions. From a5c265c4b0aefa3b9b49efa8823eefba4a20128c Mon Sep 17 00:00:00 2001 From: "mintlify-development[bot]" <109878554+mintlify-development[bot]@users.noreply.github.com> Date: Wed, 29 Jul 2026 00:52:30 +0000 Subject: [PATCH 10/12] Updated mintlify pages - Updated editor/branching-and-publishing.mdx Mintlify-Source: dashboard-editor --- editor/branching-and-publishing.mdx | 2 -- 1 file changed, 2 deletions(-) diff --git a/editor/branching-and-publishing.mdx b/editor/branching-and-publishing.mdx index 8eb7a08186..c7d3e0710b 100644 --- a/editor/branching-and-publishing.mdx +++ b/editor/branching-and-publishing.mdx @@ -8,8 +8,6 @@ The web editor autosaves everything as you type, but your changes are only live What happens when you publish depends on two things: **which branch you're on** and **whether that branch requires pull requests**. -faewfaew - ## Saving versus publishing **Saving** happens automatically. Mintlify stores your edits on its servers and persists them across browser tabs, devices, and network interruptions. From b798797b510b38729799315266cbd603f92ec572 Mon Sep 17 00:00:00 2001 From: "mintlify-development[bot]" <109878554+mintlify-development[bot]@users.noreply.github.com> Date: Wed, 29 Jul 2026 00:55:57 +0000 Subject: [PATCH 11/12] Updated mintlify pages - Updated editor/agent.mdx Mintlify-Source: dashboard-editor --- editor/agent.mdx | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) diff --git a/editor/agent.mdx b/editor/agent.mdx index 78beda5864..2da1ba53f2 100644 --- a/editor/agent.mdx +++ b/editor/agent.mdx @@ -8,12 +8,16 @@ The editor includes a built-in agent that can edit pages, reorganize navigation, The editor agent makes changes directly in your current branch. +fewafaewfeaw + ## Open the agent {/* vale Mintlify.FirstPerson = NO */} -Click **Ask agent** in the editor toolbar, or press Cmd + I (macOS) or Ctrl + I (Windows). -To close the panel, click the **X** button in the panel header or press Cmd + I again. +Click **Ask agent** in the editor toolbar, or press Cmd \+ I (macOS) or Ctrl \+ I (Windows). + +To close the panel, click the **X** button in the panel header or press Cmd \+ I again. + {/* vale Mintlify.FirstPerson = YES */} ## Send a message @@ -35,9 +39,10 @@ Example prompts: Click the paperclip icon in the chat box, or drag and drop files onto the panel. The agent reads attached files as context for your request. Supported file types: + - **Images**: JPG, PNG, GIF, WebP, SVG - **Documents**: PDF -- **Code and text**: `.js`, `.ts`, `.jsx`, `.tsx`, `.mdx`, `.md`, `.json`, `.yaml`, `.html`, `.css`, Python, Go, Rust, Ruby, Java, Swift, C, C++, SQL, shell scripts, and more +- **Code and text**: `.js`, `.ts`, `.jsx`, `.tsx`, `.mdx`, `.md`, `.json`, `.yaml`, `.html`, `.css`, Python, Go, Rust, Ruby, Java, Swift, C, C\+\+, SQL, shell scripts, and more Maximum size: 5 MB per file. Maximum: 10 files per message. @@ -97,4 +102,4 @@ Click the clock icon in the panel header to see your previous chat sessions. Cli ## AI instructions -To give the agent persistent guidance like voice rules, terminology, or formatting conventions, configure AI instructions in [Editor settings](/editor/settings#ai-instructions). The agent follows these instructions on every request without you needing to repeat them. +To give the agent persistent guidance like voice rules, terminology, or formatting conventions, configure AI instructions in [Editor settings](/editor/settings#ai-instructions). The agent follows these instructions on every request without you needing to repeat them. \ No newline at end of file From c8145754861ee083b767ef941148cd140506f435 Mon Sep 17 00:00:00 2001 From: "mintlify-development[bot]" <109878554+mintlify-development[bot]@users.noreply.github.com> Date: Wed, 29 Jul 2026 01:03:33 +0000 Subject: [PATCH 12/12] Updated mintlify pages - Updated editor/agent.mdx - Created untitled-page.mdx Mintlify-Source: dashboard-editor --- editor/agent.mdx | 4 ++-- untitled-page.mdx | 0 2 files changed, 2 insertions(+), 2 deletions(-) create mode 100644 untitled-page.mdx diff --git a/editor/agent.mdx b/editor/agent.mdx index 2da1ba53f2..5637baebd8 100644 --- a/editor/agent.mdx +++ b/editor/agent.mdx @@ -8,8 +8,6 @@ The editor includes a built-in agent that can edit pages, reorganize navigation, The editor agent makes changes directly in your current branch. -fewafaewfeaw - ## Open the agent {/* vale Mintlify.FirstPerson = NO */} @@ -54,6 +52,8 @@ In visual mode, select text on a page. A floating toolbar appears over the selec As the agent edits your pages, a **Changed files** panel appears in the chat. Expand it to see a list of every file modified in the session. Click any file to open it in diff view and compare the agent's changes against the original. +Hello there + ## What the agent can do ### Edit pages diff --git a/untitled-page.mdx b/untitled-page.mdx new file mode 100644 index 0000000000..e69de29bb2