Editing
Web Editor
Edit your docs directly from the dashboard with live previews.
Mintlify Web Editor is currently in beta. Contact support@mintlify.com for feedback.
Web Editor allows you to edit docs directly without using an IDE or running mintlify dev
. It includes git workflow features and a fully editable experience with custom components.
Git Workflow
- Create a Branch: Click the branches modal on the top left to create or switch branches.
- Make Changes: Edit your content using the editor.
- Commit Changes:
- On main branch: Click “Publish”
- On other branches: Click “Save Changes” or “Publish Pull Request”
Install the Mintlify GitHub app from the GitHub App page before making changes.
Editing Content
Using Slash Commands
Type /
in Visual Editor mode to access commands for adding:
- Standard blocks (paragraphs, headings, lists, tables, images, blockquotes)
- Mintlify components (callouts, accordions, cards, code blocks, tabs, steps, frames)
Managing Images
- Add images: Type
/image
to upload or select existing images - Edit images: Hover over an image to see edit and delete options
Editor Modes
- Visual Editor: WYSIWYG editing with live preview
- Source Editor: Direct MDX code editing
- Diff View: Review changes before committing
Current Limitations
- Navigation tree cannot be live-updated
- No preview for custom snippets or OpenAPI specs
- Some keyboard navigation issues
For feedback or support, contact support@mintlify.com
Was this page helpful?