diff --git a/editor/pages.mdx b/editor/pages.mdx index c97a43705..83fae1e03 100644 --- a/editor/pages.mdx +++ b/editor/pages.mdx @@ -29,7 +29,7 @@ Switch between visual and Markdown mode with the toggle in the toolbar. **Visual mode** shows a real-time preview as you type. Press / to open the component menu and insert components, images, videos, and other content. You can also drag and drop media files directly onto the page. Other shortcuts: -- **Insert a link**: Select text and press Cmd + K (macOS) or Ctrl + K (Windows), or drag a page from the navigation tree into the editor to create a link with the page title. +- **Insert a link**: Select text and press Cmd + K (macOS) or Ctrl + K (Windows), or drag a page from the navigation tree into the editor to create a link with the page title. You can also paste a link copied from another page in the same branch (see [Copy a link to a page](#copy-a-link-to-a-page)) and the editor automatically converts it into an internal link to that page. - **Insert an emoji**: Type : followed by a keyword to open the emoji picker. - **Edit a table**: When your cursor is inside a table, use the floating toolbar to add or remove rows and columns, or merge cells. @@ -79,6 +79,16 @@ Diff view is read-only. Click the button next to the mode togg - **Rename**: Right-click a page and select **Rename**. - **Duplicate**: Right-click a page and select **Duplicate**. - **Delete**: Right-click a page and select **Delete**. The editor removes the page from navigation automatically. +- **Copy a link to a page**: Right-click a page and select **Copy link** to copy a direct link to the page in the editor. Share the link with teammates who have editor access, or paste it into another page on the same branch to create an internal link. + +### Copy a link to a page + +Use **Copy link** to share a deep link to a specific page in the web editor or to quickly cross-link pages within your docs. + +- **Share with teammates**: Paste the copied link into a chat or pull request. Anyone with access to your Mintlify organization opens the page directly in their editor session on the same branch. +- **Create internal links**: Paste the copied link into a page on the same branch in visual mode. The editor recognizes the link, replaces it with the target page's title, and converts it into an internal link to that page. + +The pasted link is only converted automatically when the source and target pages are on the same organization, project, and branch. Links to pages on other branches or projects paste as plain URLs. ### Pages deleted via Git