mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
mintlify[bot]
d2c373e8c2
* docs: dedupe editor pages against canonical guides and settings * docs: mirror editor dedupe into es, fr, zh and fix long descriptions --------- Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
76 lines
4.7 KiB
Plaintext
76 lines
4.7 KiB
Plaintext
---
|
|
title: "Create and edit pages"
|
|
sidebarTitle: "Edit content"
|
|
description: "Create pages, edit content, add media, organize your navigation, restore earlier page versions, and manage private pages in the editor."
|
|
keywords: ["editor", "content", "pages", "navigation", "version history", "media", "images", "private pages"]
|
|
---
|
|
|
|
## Home and Publishing
|
|
|
|
The editor workspace is split into two tabs: **Home** and **Publishing**.
|
|
|
|
**Home** is your workspace. It shows the content files in your repository, including your private pages, whether or not they appear on your published site.
|
|
|
|
**Publishing** is your published site. It shows the navigation your visitors see, along with your site settings.
|
|
|
|
{/* vale Mintlify.OxfordComma = NO */}
|
|
Home hides some files by default, including `docs.json`, files and folders whose names start with a dot, files with no extension, all-caps Markdown files like `README.md`, and `.css`, `.js`, `.jsx`, `.mjs`, `.cjs`, and `.pdf` files. To see all files, turn on [Show all files](/editor/settings) or press <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>.</kbd> (macOS) or <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>.</kbd> (Windows).
|
|
{/* vale Mintlify.OxfordComma = YES */}
|
|
|
|
## Create a page
|
|
|
|
To add a page to your navigation, click the <Icon icon="plus" /> plus button on the navigation element where you want it. Enter a name for your page. The editor adds the `.mdx` extension for you.
|
|
|
|
## Add media
|
|
|
|
Type <kbd>/image</kbd> or <kbd>/video</kbd> to upload a file or pick one already in your repository. You can also drag files from your computer onto the page. To reuse media, drag an image or video from the navigation tree onto a page.
|
|
|
|
- Uploads save to your `images/` and `videos/` folders and commit with your next publish.
|
|
- Supported formats are PNG, JPG, JPEG, GIF, WebP, SVG, MP4, and WebM.
|
|
- To serve different images in light and dark mode, hover an inserted image and use **Light/dark variants**.
|
|
- Type <kbd>/embed</kbd> and paste a YouTube, Loom, or Vimeo URL to generate the iframe. For anything else, toggle **Manual embed** to write custom HTML.
|
|
|
|
For formatting images and using the Frame component, see [Images and embeds](/create/image-embeds).
|
|
|
|
## Organize navigation
|
|
|
|
Drag elements in the Navigation view to reorder or nest them. The editor writes your changes to `docs.json` when you publish. For what each navigation element does, including groups, tabs, anchors, dropdowns, menus, products, versions, and languages, see [Navigation](/organize/navigation).
|
|
|
|
<Note>
|
|
Some elements can't nest inside others. Tabs can't nest inside groups, for example. The editor prevents invalid combinations.
|
|
</Note>
|
|
|
|
To change a page's title, slug, description, or layout, open its settings from the navigation tree. See [Pages](/organize/pages) for more information on specific settings.
|
|
|
|
## Delete a page
|
|
|
|
To delete a page, click <Icon icon="ellipsis" /> **More options** in the top-right of the page, then click **Move to trash**. You can also delete a page from its options menu in the navigation tree. For private pages, the menu shows **Delete page**.
|
|
|
|
Deleting a page removes both the file and its navigation entry. To remove a page from your published navigation without deleting its file, select **Remove from publishing** in the page's options menu in the navigation tree.
|
|
|
|
Editors and admins can delete pages.
|
|
|
|
## Version history
|
|
|
|
Version history lets you review and restore earlier saved versions of a page. It isn't available for `docs.json`.
|
|
|
|
Viewers can review and compare saved versions of private pages. Editors and admins can restore them.
|
|
|
|
The editor records a new entry whenever content differs from the latest recorded version. Version history is branch-scoped. Only the current branch's version history is available.
|
|
|
|
To view version history, click <Icon icon="ellipsis" /> **More options** in the top-right of the page, then click **Version history**.
|
|
|
|
If you restore a version, it overwrites any unsaved changes you made to the page. When you restore a public page, it is only restored on your current branch. When you restore a private page, it is restored on all branches.
|
|
|
|
## Private pages
|
|
|
|
Private pages are drafts that live in the **Personal** section of the **Home** tab. They are private to you, are not committed to your repository, and never appear on your published site.
|
|
|
|
To create a private page or folder, click the <Icon icon="plus" /> plus button on the **Personal** section header, then select **New page** or **New folder**.
|
|
|
|
Dragging a private page or folder into your workspace makes it available to your collaborators immediately, though it is not added to your site navigation.
|
|
|
|
<Warning>
|
|
You can't move workspace content back to the **Personal** section. Making a private page public is a one-way change.
|
|
</Warning>
|