Live Editing

Neko provides a seamless live editing experience when running your site in watch mode. This allows you to edit content directly from your browser without needing to switch context between an editor and the documentation preview.

Getting Started

To enable live editing, simply run the Neko CLI with the watch command:

neko watch --input docs/

When you navigate to your locally hosted site, Neko injects an embedded Monaco Editor instance into the page.

Editing Pages and Folders

There are two primary ways to access the editor:

1. Global Editor Shortcut: You can press Ctrl + I (or Cmd + I on macOS) anywhere on a page to open the Monaco Editor with the markdown content of the current page.
2. Sidebar Pencil Icon: When hovering over folder items in the sidebar, a pencil icon will appear. Clicking this icon opens the editor specifically targeted at the folder's configuration file (index.yml), allowing you to quickly modify metadata such as order, title, or icon.

Component Auto-Complete

To help you remember and quickly insert Neko's extensive custom components, the built-in editor supports auto-complete snippets.

While editing a markdown file, type the prefix neko- to trigger a dropdown containing templates for all supported custom syntax blocks, such as tabs, alerts, callouts, cards, and more.

This ensures you can always access the right snippet structure without leaving the browser or consulting external documentation.