Skip to content

docs: document editor file explorer shortcut and settings menu #5859

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
mintlify wants to merge 2 commits into
base: main
Choose a base branch
from
Open

docs: document editor file explorer shortcut and settings menu #5859

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
810193f
docs: document file explorer shortcut and updated editor settings menu
mintlify[bot] May 19, 2026
9ae99ed
docs: translate editor shortcut and settings menu updates
mintlify[bot] May 19, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions editor/keyboard-shortcuts.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,10 @@
| Command | macOS | Windows |
| :--- | :--- | :--- |
| **Search files and content** | <kbd>Cmd</kbd> + <kbd>K</kbd> | <kbd>Ctrl</kbd> + <kbd>K</kbd> |
| **Toggle file explorer** | <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>F</kbd> | <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>F</kbd> |
| **Toggle Markdown mode** | <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>M</kbd> | <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>M</kbd> |

Toggling the file explorer swaps the left sidebar between the navigation tree and a file-system view of your repository. The shortcut works even when you're focused inside the editor.

### Text formatting

Expand Down Expand Up @@ -52,7 +56,7 @@
| **Add link** to selected text | <kbd>Cmd</kbd> + <kbd>K</kbd> | <kbd>Ctrl</kbd> + <kbd>K</kbd> |
| **Add line break** | <kbd>Cmd</kbd> + <kbd>Enter</kbd> | <kbd>Ctrl</kbd> + <kbd>Enter</kbd> |
| **Component menu** | <kbd>/</kbd> | <kbd>/</kbd> |
| **Emoji picker** | <kbd>:</kbd> + keyword | <kbd>:</kbd> + keyword |

Check warning on line 59 in editor/keyboard-shortcuts.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

editor/keyboard-shortcuts.mdx#L59 

Use 'emojis?' instead of 'Emoji'.

### Smart substitutions

Expand Down Expand Up @@ -93,6 +97,6 @@

| Command | macOS | Windows |
| :--- | :--- | :--- |
| **Add cursor** | <kbd>Option</kbd> + Click | <kbd>Alt</kbd> + Click |

Check warning on line 100 in editor/keyboard-shortcuts.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

editor/keyboard-shortcuts.mdx#L100 

Use 'Cursor' instead of 'cursor'.
| **Add cursor above** | <kbd>Cmd</kbd> + <kbd>Option</kbd> + <kbd>↑</kbd> | <kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>↑</kbd> |

Check warning on line 101 in editor/keyboard-shortcuts.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

editor/keyboard-shortcuts.mdx#L101 

Use 'Cursor' instead of 'cursor'.

Check warning on line 101 in editor/keyboard-shortcuts.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

editor/keyboard-shortcuts.mdx#L101 

Use 'preceding' instead of 'above'.
| **Add cursor below** | <kbd>Cmd</kbd> + <kbd>Option</kbd> + <kbd>↓</kbd> | <kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>↓</kbd> |

Check warning on line 102 in editor/keyboard-shortcuts.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

editor/keyboard-shortcuts.mdx#L102 

Use 'Cursor' instead of 'cursor'.
8 changes: 4 additions & 4 deletions editor/settings.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,9 +7,9 @@
The web editor has two layers of settings:

- **Your settings** apply only to you and control how the editor's AI assists with your edits.
- **Publishing settings** apply to everyone on a deployment and shape what happens when changes are committed and turned into pull requests.

Check warning on line 10 in editor/settings.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

editor/settings.mdx#L10 

In general, use active voice instead of passive voice ('are committed').

You can configure both from the **Settings** menu in the editor.
You can configure both from the **Editor settings** dialog. Open it from the <Icon icon="ellipsis" /> menu in the editor top bar.

## AI instructions

Expand All @@ -20,7 +20,7 @@
- **Edit with AI** actions on a selection, such as rewrite, expand, or fix.
- **Agent sessions** started from the editor.

Instructions are scoped to your user account, so each teammate maintains their own.

Check warning on line 23 in editor/settings.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

editor/settings.mdx#L23 

In general, use active voice instead of passive voice ('are scoped').

### When to use AI instructions

Expand All @@ -35,8 +35,8 @@

### Configure AI instructions

1. Open the editor and click your avatar in the toolbar.
2. Select **Settings**.
1. In the editor top bar, click the <Icon icon="ellipsis" /> menu and select **Editor settings**.
2. Open the **Chat** section.
3. In the **AI instructions** field, enter the guidance you want the AI to follow.
4. Save your changes.

Expand All @@ -54,7 +54,7 @@

## Publishing settings

Publishing settings are configured per deployment and apply to everyone who publishes from the editor. They control how pull requests and commits are generated, opened, and merged.
Publishing settings are configured per deployment and apply to everyone who publishes from the editor. They control how pull requests and commits are generated, opened, and merged. You can find them in the **Publishing** section of the **Editor settings** dialog.

Check warning on line 57 in editor/settings.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

editor/settings.mdx#L57 

In general, use active voice instead of passive voice ('are configured').

Check warning on line 57 in editor/settings.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

editor/settings.mdx#L57 

In general, use active voice instead of passive voice ('are generated').

You need admin access to your Mintlify deployment to change publishing settings.

Expand Down Expand Up @@ -112,9 +112,9 @@

- **Merge**: Creates a merge commit that preserves the full branch history.
- **Squash**: Combines all commits in the branch into a single commit on your deployment branch.
- **Rebase**: Replays each commit from the branch onto your deployment branch without a merge commit.

Check warning on line 115 in editor/settings.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

editor/settings.mdx#L115 

Did you really mean 'Rebase'?

The selected method is used by default. If you pass an explicit merge method through the API or your Git provider's UI, that choice takes precedence.

Check warning on line 117 in editor/settings.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

editor/settings.mdx#L117 

In general, use active voice instead of passive voice ('is used').

<Tip>
Match your default merge method to your Git provider's branch protection settings. If your deployment branch only allows squash merges, set the default to **Squash** to avoid failed merges from the editor.
Expand Down
4 changes: 4 additions & 0 deletions es/editor/keyboard-shortcuts.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,10 @@ Usa estos atajos de teclado al editar en modo visual.
| Comando | macOS | Windows |
| :--- | :--- | :--- |
| **Buscar archivos y contenido** | <kbd>Cmd</kbd> + <kbd>K</kbd> | <kbd>Ctrl</kbd> + <kbd>K</kbd> |
| **Mostrar u ocultar el explorador de archivos** | <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>F</kbd> | <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>F</kbd> |
| **Alternar el modo Markdown** | <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>M</kbd> | <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>M</kbd> |

Al mostrar el explorador de archivos, la barra lateral izquierda alterna entre el árbol de navegación y una vista de los archivos de tu repositorio. El atajo funciona incluso cuando el foco está dentro del editor.

<div id="text-formatting">
### Formato de texto
Expand Down
8 changes: 4 additions & 4 deletions es/editor/settings.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ El editor web tiene dos capas de configuración:
- **Tu configuración** se aplica solo a ti y controla cómo la IA del editor te ayuda con tus ediciones.
- **La configuración de publicación** se aplica a todos los miembros de un deployment y determina qué sucede cuando los cambios se confirman y se convierten en pull requests.

Puedes configurar ambas desde el menú **Settings** en el editor.
Puedes configurar ambas desde el cuadro de diálogo **Editor settings**. Ábrelo desde el menú <Icon icon="ellipsis" /> en la barra superior del editor.

<div id="ai-instructions">
## Instrucciones de IA
Expand Down Expand Up @@ -41,8 +41,8 @@ Mantén las instrucciones cortas y específicas. La IA las sigue en cada solicit
### Configurar las instrucciones de IA
</div>

1. Abre el editor y haz clic en tu avatar en la barra de herramientas.
2. Selecciona **Settings**.
1. En la barra superior del editor, haz clic en el menú <Icon icon="ellipsis" /> y selecciona **Editor settings**.
2. Abre la sección **Chat**.
3. En el campo **AI instructions**, introduce las pautas que quieres que siga la IA.
4. Guarda los cambios.

Expand All @@ -62,7 +62,7 @@ Deja el campo vacío para eliminar tus instrucciones.
## Configuración de publicación
</div>

La configuración de publicación se establece por deployment y se aplica a todas las personas que publican desde el editor. Controla cómo se generan, se abren y se fusionan los pull requests y los commits.
La configuración de publicación se establece por deployment y se aplica a todas las personas que publican desde el editor. Controla cómo se generan, se abren y se fusionan los pull requests y los commits. La encuentras en la sección **Publishing** del cuadro de diálogo **Editor settings**.

Necesitas acceso de administrador a tu deployment de Mintlify para cambiar la configuración de publicación.

Expand Down
4 changes: 4 additions & 0 deletions fr/editor/keyboard-shortcuts.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,10 @@ Utilisez ces raccourcis lorsque vous modifiez en mode visuel.
| Commande | macOS | Windows |
| :--- | :--- | :--- |
| **Rechercher des fichiers et du contenu** | <kbd>Cmd</kbd> + <kbd>K</kbd> | <kbd>Ctrl</kbd> + <kbd>K</kbd> |
| **Afficher ou masquer l'explorateur de fichiers** | <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>F</kbd> | <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>F</kbd> |
| **Basculer le mode Markdown** | <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>M</kbd> | <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>M</kbd> |

L'affichage de l'explorateur de fichiers fait basculer la barre latérale gauche entre l'arborescence de navigation et une vue des fichiers de votre dépôt. Le raccourci fonctionne même lorsque le focus est dans l'éditeur.

<div id="text-formatting">
### Mise en forme du texte
Expand Down
8 changes: 4 additions & 4 deletions fr/editor/settings.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ L'éditeur web comporte deux niveaux de paramètres :
- **Vos paramètres** ne s'appliquent qu'à vous et contrôlent la façon dont l'IA de l'éditeur vous assiste pendant vos modifications.
- **Les paramètres de publication** s'appliquent à toutes les personnes d'un déploiement et déterminent ce qui se passe lorsque les modifications sont committées puis transformées en pull requests.

Vous pouvez configurer les deux depuis le menu **Settings** de l'éditeur.
Vous pouvez configurer les deux depuis la boîte de dialogue **Editor settings**. Ouvrez-la depuis le menu <Icon icon="ellipsis" /> dans la barre supérieure de l'éditeur.

<div id="ai-instructions">
## Instructions d'IA
Expand Down Expand Up @@ -41,8 +41,8 @@ Gardez les instructions courtes et précises. L'IA les suit à chaque requête,
### Configurer les instructions d'IA
</div>

1. Ouvrez l'éditeur et cliquez sur votre avatar dans la barre d'outils.
2. Sélectionnez **Settings**.
1. Dans la barre supérieure de l'éditeur, cliquez sur le menu <Icon icon="ellipsis" /> et sélectionnez **Editor settings**.
2. Ouvrez la section **Chat**.
3. Dans le champ **AI instructions**, saisissez les consignes que l'IA doit suivre.
4. Enregistrez vos modifications.

Expand All @@ -62,7 +62,7 @@ Laissez le champ vide pour supprimer vos instructions.
## Paramètres de publication
</div>

Les paramètres de publication se configurent par déploiement et s'appliquent à toutes les personnes qui publient depuis l'éditeur. Ils contrôlent la façon dont les pull requests et les commits sont générés, ouverts et fusionnés.
Les paramètres de publication se configurent par déploiement et s'appliquent à toutes les personnes qui publient depuis l'éditeur. Ils contrôlent la façon dont les pull requests et les commits sont générés, ouverts et fusionnés. Vous les trouverez dans la section **Publishing** de la boîte de dialogue **Editor settings**.

Vous devez disposer d'un accès administrateur à votre déploiement Mintlify pour modifier les paramètres de publication.

Expand Down
4 changes: 4 additions & 0 deletions zh/editor/keyboard-shortcuts.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,10 @@ keywords: ["编辑器", "快捷键", "键盘", "快捷方式"]
| 命令 | macOS | Windows |
| :--- | :--- | :--- |
| **搜索文件和内容** | <kbd>Cmd</kbd> + <kbd>K</kbd> | <kbd>Ctrl</kbd> + <kbd>K</kbd> |
| **切换文件浏览器** | <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>F</kbd> | <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>F</kbd> |
| **切换 Markdown 模式** | <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>M</kbd> | <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>M</kbd> |

切换文件浏览器会让左侧边栏在导航树和仓库文件视图之间切换。即使焦点在编辑器内，该快捷键也能生效。

<div id="text-formatting">
### 文本格式化
Expand Down
8 changes: 4 additions & 4 deletions zh/editor/settings.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ Web 编辑器有两层设置：
- **个人设置**仅对你生效，控制编辑器的 AI 在你编辑时如何提供协助。
- **发布设置**对部署中的所有人生效，决定变更在被提交并转换为 pull request 时如何处理。

你可以在编辑器的 **Settings** 菜单中配置这两项。
你可以在 **Editor settings** 对话框中配置这两项。在编辑器顶部栏的 <Icon icon="ellipsis" /> 菜单中打开它。

<div id="ai-instructions">
## AI 指令
Expand Down Expand Up @@ -41,8 +41,8 @@ AI 指令是编辑器随你的请求一起发送给 AI 的持续生效指令。
### 配置 AI 指令
</div>

1. 打开编辑器，点击工具栏中的头像。
2. 选择 **Settings**。
1. 在编辑器顶部栏中，点击 <Icon icon="ellipsis" /> 菜单并选择 **Editor settings**。
2. 打开 **Chat** 部分。
3. 在 **AI instructions** 字段中输入希望 AI 遵循的指令。
4. 保存更改。

Expand All @@ -62,7 +62,7 @@ AI 指令是编辑器随你的请求一起发送给 AI 的持续生效指令。
## 发布设置
</div>

发布设置按部署进行配置，对所有从编辑器发布的人都生效。它们控制 pull request 和提交的生成、打开和合并方式。
发布设置按部署进行配置，对所有从编辑器发布的人都生效。它们控制 pull request 和提交的生成、打开和合并方式。你可以在 **Editor settings** 对话框的 **Publishing** 部分中找到它们。

你需要拥有 Mintlify 部署的管理员权限才能更改发布设置。

Expand Down
Loading