Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
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
45 changes: 45 additions & 0 deletions editor.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -112,6 +112,51 @@

Press <kbd>Command</kbd> + <kbd>P</kbd> on macOS or <kbd>Ctrl</kbd> + <kbd>P</kbd> on Windows to search for files by name.

### Manage images and media

The visual editor includes an Images and Media view for browsing, previewing, and managing your image and video assets. Access it by selecting **Images and Media** from the sidebar.

<Frame>
<img
src="/images/editor/media-manager-light.png"
alt="Images and Media view in the visual editor"
className="block dark:hidden"
/>

<img
src="/images/editor/media-manager-dark.png"
alt="Images and Media view in the visual editor"
className="hidden dark:block"
/>
</Frame>

#### View modes

Switch between two view modes to browse your assets:

- **Tree view**: Navigate assets organized by folder structure. Expand and collapse folders to find specific files.
- **Gallery view**: Browse assets as thumbnails grouped by folder. Scroll horizontally through each folder's assets.

Use the view toggle button in the toolbar to switch between tree and gallery views.

#### Preview assets

Select any image or video to preview it in the main panel. The preview shows:

- Full-size image or video player
- File metadata including size and dimensions
- File path for easy reference

#### Configure assets

Right-click on any file or folder to access configuration options:

- **File options**: View and edit file name, path, size, type, and dimensions
- **Folder options**: View and edit folder name, path, and file count
- **Copy path**: Copy the file or folder path to your clipboard for use in your documentation

The configure sheet displays all metadata for the selected asset, making it easy to reference file details when writing documentation.

### Create new pages

Select the **Create a new file** icon in the file explorer sidebar.
Expand Down Expand Up @@ -269,7 +314,7 @@
/>
</Frame>

If you authorize Mintlify to your GitHub user, your commits will be signed as if you had made them yourself. If not, they will be signed by the Mintlify GitHub app.

Check warning on line 317 in editor.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

editor.mdx#L317

Avoid using 'will'.

Check warning on line 317 in editor.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

editor.mdx#L317

In general, use active voice instead of passive voice ('be signed').

Check warning on line 317 in editor.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

editor.mdx#L317

Avoid using 'will'.

Check warning on line 317 in editor.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

editor.mdx#L317

In general, use active voice instead of passive voice ('be signed').

### Pull requests and reviewing changes

Expand All @@ -296,7 +341,7 @@
- Any specific areas that need review
</Step>
<Step title="Create and share">
Select **Publish Pull Request**. The editor will provide a link to view your pull request.

Check warning on line 344 in editor.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

editor.mdx#L344

Avoid using 'will'.

<Frame>
<img
Expand Down
11 changes: 11 additions & 0 deletions guides/media.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -23,3 +23,14 @@
* **Videos** for abstract concepts and long workflows.

Use media sparingly and intentionally to avoid unnecessary documentation debt. When done right, it enhances comprehension without adding maintenance burdens or accessibility barriers.

## Managing media assets

The visual editor includes an Images and Media view for managing your image and video assets. Access it from the sidebar to:

- Browse assets in tree or gallery view
- Preview images and videos
- View file metadata (size, dimensions, path)

Check warning on line 33 in guides/media.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

guides/media.mdx#L33

Use parentheses judiciously.
- Copy file paths for use in your documentation

See [Visual editor](/editor#manage-images-and-media) for more information on using the Images and Media view.
Loading