mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
Ethan Palm
7d545c9699
* Add Markdown mode shortcuts to keyboard shortcuts reference Restructure the keyboard shortcuts page to cover both Visual mode and Markdown mode (Monaco editor). Visual mode shortcuts remain unchanged. New Markdown mode section documents standard VS Code shortcuts for find/replace, line manipulation, and multi-cursor editing. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> * update keyboard shortcuts * remove out of date screenshots * copy edit index * add missing images * add info to pages * copy edit * concision for media page * copy edit publish * update live preview * update index * add features to index --------- Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
55 lines
1.8 KiB
Plaintext
55 lines
1.8 KiB
Plaintext
---
|
|
title: "Add media"
|
|
description: "Upload and use images and assets in your documentation."
|
|
keywords: ["editor", "media", "images", "assets"]
|
|
---
|
|
|
|
## Supported file types
|
|
|
|
- **Images**: PNG, JPG, JPEG, SVG, GIF, WebP
|
|
- **Videos**: MP4, WebM
|
|
- **Fonts**: TTF, WOFF, WOFF2
|
|
- **Other**: PDF, ICO (favicons)
|
|
|
|
## Add media to a page
|
|
|
|
### Drag and drop
|
|
|
|
Drag and drop media from your computer or the asset manager onto a page in visual mode. Files save to the root of your `images/` folder.
|
|
|
|
### Slash command
|
|
|
|
Type <kbd>/image</kbd> to open the image menu, then upload a new image or select an existing one.
|
|
|
|
### Upload files
|
|
|
|
Use the asset manager in the sidebar to upload or search for files.
|
|
|
|
<Frame>
|
|
<img src="/images/editor/assets-light.png" alt="Assets manager selected in the editor sidebar menu." className="block dark:hidden" />
|
|
<img src="/images/editor/assets-dark.png" alt="Assets manager selected in the editor sidebar menu." className="hidden dark:block" />
|
|
</Frame>
|
|
|
|
Click **Upload** in the asset manager to add files from your computer.
|
|
|
|
## Manage assets
|
|
|
|
### Organize with folders
|
|
|
|
Click the **+** button in the file explorer to create a new folder. Drag and drop files and folders in the file tree to reorganize them.
|
|
|
|
### Rename and edit assets
|
|
|
|
Hover over an asset and click the **...** button to rename the file or update its alt text.
|
|
|
|
### Delete assets
|
|
|
|
Hover over an asset and click the <Icon icon="trash" /> delete button.
|
|
|
|
## Best practices
|
|
|
|
- **Use descriptive names**: Name files clearly, like `api-dashboard-light.png` instead of `img1.png`.
|
|
- **Add alt text**: Provide descriptive alt text for accessibility and SEO.
|
|
- **Organize with folders**: Group related assets, such as light and dark mode variants or assets for a specific feature area.
|
|
- **Use appropriate formats**: PNG for graphics with transparency, JPG for photos, SVG for icons and logos.
|