Guidances are at the heart of how you configure AI Agent behavior and manage knowledge across your platform. With this update, we've significantly upgraded the guidance editor to match the standards you'd expect from a modern writing tool.

The new editor introduces markdown shortcuts, keyboard-first workflows, inline commands for variables and actions, and improved formatting controls, making it faster and more intuitive to create and edit guidances.

Here’s the list of new or improved features we added:

1. Slash and @ commands

You can now type / or @ to open an inline command menu for inserting variables and actions. Navigate categories with left/right arrow keys, browse items with up/down, and press Enter to select. Typing /order will automatically filter and only return variables and actions containing "order" in the name.

2. Making commands more discoverable

When in edit mode, the editor always shows "Type '/' or '@' to insert variables and actions" at the top, guiding users toward the new inline commands.

3. Copy variables and actions

You can now copy variables and actions that are already in the editor. Before, they would get lost when you tried to copy-paste content. Now they persist as expected.

4. Paste markdown content

You can now paste Markdown into the editor and it converts automatically, headings, lists, bold, italic, links, all of it. Copying content from a README, a Notion doc, or ChatGPT just works.

5. Markdown-style shortcuts for lists

You can now type 1. followed by a space and it automatically converts to a numbered list. Same thing with - or * followed by a space for bulleted lists. No more reaching for the toolbar, just type naturally.

6. Tab indentation for lists

Once you're in a list, Tab and Shift+Tab now indent and unindent items without stealing focus from the editor.

7. Numbered list nesting cycles through styles

When you indent numbered lists, they now cycle through different numbering styles: 1., then a., then i.. Nested lists actually look like proper nested lists now, not just the same numbers at different depths.

8. Convert between list types inline

If you're in a numbered list and type - at the beginning of a line and then press space, it converts to a bulleted list and vice versa. You can switch list types on the fly without going back to the toolbar.

9. Smart list behavior on Enter

Pressing Enter on an empty nested list item now un-indents you instead of creating a new empty line.

10. Markdown-style headings

You can now type #, ##, or ### followed by a space to get headings, just like Markdown. You can also pick them from the toolbar dropdown.

11. Horizontal rule shortcut

Type --- and you get a line separator.

12. Find and Replace

We added a Find and Replace dialog. Hit Cmd+F to search, it highlights matches in the editor and lets you navigate through them via the navigation buttons or arrow keys.

13. Smart URL pasting

If you select some text and paste a URL, it automatically turns the selected text into a hyperlink. No more "select text, click link button, paste URL" workflow.

14. Improved link editing with Cmd+K

When you select text and hit Cmd+K to create a link, the dialog now pre-fills with the selected text as the anchor. Before, it would show the modal next to the toolbar, which was confusing.

We’ve also recorded a walkthrough video to help you get familiar with all the new features: https://www.loom.com/share/b0326a606d4d4e95896a4fbfa3922db4