Editing and preview

Open a document#

Create guide.adoc:

= Project guide

== Getting started

A paragraph with *bold* and _italic_ text.

[source,javascript]
----
console.log('hello');
----

Open the split preview. The heading, inline formatting, and code block should render. Choose source-only, split, or preview-oriented work according to the task, and configure scroll synchronization in settings.

Edit structured content#

Use completion for macros, attributes, includes, images, source languages, and cross-references. Use the Structure view to move between sections. The Generate menu and formatting actions insert common constructs without requiring you to memorize every delimiter.

Right-click a table to add, remove, or move rows and columns. Reformat and inspect the rendered result, especially when cells contain multiline content.

Refactor and inspect#

Use Rename for supported references and Extract to Include or Inline Include when restructuring a long document. Review changed paths and the diff. The inspection set checks common authoring problems and offers focused fixes; review the preview and the site’s own build after applying them.