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
49 changes: 49 additions & 0 deletions editor.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -112,6 +112,55 @@

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 Images and Media view provides a centralized interface for browsing, previewing, and managing your image and video assets.

#### Access the media manager

Select **Images and Media** from the sidebar navigation to open the media manager.

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

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

#### View modes

The media manager offers two view modes to help you browse your assets:

- **Tree view**: Browse assets organized by folder structure. This view is ideal for navigating large collections of assets organized in directories.
- **Gallery view**: Browse assets as thumbnails grouped by folder. This view is ideal for quickly scanning and identifying visual assets.

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

#### Preview assets

Select any image or video asset to preview it in the preview panel. The preview panel displays:

- Full-size preview of images
- Video playback controls for video files
- File metadata including dimensions and file size

#### Configure assets

Select the kebab menu icon on any file or folder to access configuration options:

- **Configure**: View and edit file metadata including file name, path, size, and dimensions
- **Copy path**: Copy the file path to your clipboard for use in your documentation
- **Delete**: Remove the file or folder from your repository

The configuration sheet displays detailed information about your selected asset, making it easy to reference file paths and verify asset properties.

### Create new pages

Select the **Create a new file** icon in the file explorer sidebar.
Expand Down Expand Up @@ -269,7 +318,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 321 in editor.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

editor.mdx#L321

Avoid using 'will'.

Check warning on line 321 in editor.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

editor.mdx#L321

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

Check warning on line 321 in editor.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

editor.mdx#L321

Avoid using 'will'.

Check warning on line 321 in editor.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

editor.mdx#L321

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

### Pull requests and reviewing changes

Expand All @@ -296,7 +345,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 348 in editor.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

editor.mdx#L348

Avoid using 'will'.

<Frame>
<img
Expand Down
4 changes: 4 additions & 0 deletions guides/media.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,10 @@ keywords: ["screenshots", "GIFs", "videos", "media best practices"]

Screenshots, GIFs, and videos can enhance documentation but require ongoing maintenance as UI elements change. Use them selectively to avoid unnecessary upkeep.

<Note>
Use the [Images and Media view](/editor#manage-images-and-media) in the visual editor to browse, preview, and manage your image and video assets in one centralized location.
</Note>

Key guidelines:

- **Media should be supplementary.** If a workflow is clear in text alone, avoid adding visuals.
Expand Down
Loading