Jump to Content

Launch Week

June 28th, 2025

We’ve added the ability to have a "Run in Postman" button in your docs, so your developers can access Postman Collections quickly.

Generate your MCP server to use with clients like Cursor, VSCode, or Claude Code.

Use branches to make changes across multiple pages, and review them with teammates in a preview environment.

We’re officially bringing ReadMe Refactored to our Enterprise customers.

We’ve added support for new themes like Compact, Modern, and Sidebar (coming soon). Along with options for wide layouts, and unique icons on pages.

Now in beta, you can edit content with our AI Agent. Ask it adhere to a styleguide, or rewrite a page.

New Features & Improvements

Admin

You can now close Settings, Branches, and the AI menus by pressing esc Refactored
Added page views in Documentation Metrics for .md endpoints
Improved semver validation for versions

API V2

New endpoints for making changes to Recipes Refactored
New endpoints for uploading images (including your logos) Refactored
Improved handling of large OAS uploads Refactored
Improved consistency when getting project URIs from content responses Refactored

Branches

Users can now create a branch from changes made in a version Refactored

Editor

Improved delete and enter behavior in editor. If the cursor is before a code, html, mdx, or table it will no longer delete the block. enter can now be used to leave focus when editing certain blocks
Improved UI for setting code block syntax and tab names
Improved highlight colors for dark mode
Custom Pages can be swapped between Markdown and HTML while preserving existing content
Added enter hotkey to open Reusable Content when it has focus

Performance

Reduced the amount of JS loaded on pages
Improved how we fetch sidebar, files, API definitions, components, and reusable component data

Bugs Eaten (by Owlbert) 🐛

Admin

Fixed an issue where the Search placeholder would be tiny in Safari Refactored

API Reference

Fixed an issue where example tabs with long names could overlap improperly
Fixed an issue where users couldn‘t edit API definitions if the definition container server variables Refactored

Branches

Fixed an issue where users couldn’t view OAS files from a branch Refactored
Fixed an issue where users could create merge conflicts that Git can’t safely merge. Users will now be warned before continuing those merges Refactored

Docs

Fixed an issue where empty categories were publicly visible
Fixed an issue where the incorrect logo would be shown until dark/light mode is toggled

Editor

Fixed an issue where image max-width wasn’t updating onBlur
Fixed an issue where especially large pages could not be edited
Fixed an issue where paragraphs could be added by pressing the up arrow at the top of a page

Enterprise

Fixed an issue where Enterprise customers could not update their OAuth apps

Recipes

Fixed an issue where direct links to a Recipe were not working Refactored

Refactored Some improvements are only available once your project has been upgraded.