> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nulix.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Articles: The Building Blocks of Your Knowledge Base

> Understand article anatomy, lifecycle states, revision history, and how to use the Nulix editor to write and publish great documentation.

Articles are the individual pages of content that make up your Nulix knowledge base. Every article belongs to a category, carries its own metadata, and moves through a defined lifecycle — from first draft to published and, eventually, archived. Think of articles as the atomic unit of your documentation: focused, self-contained, and discoverable through both navigation and search. Nulix gives you a rich text and Markdown editor, so writers of any background can contribute without friction.

## Article Anatomy

Each article in Nulix is made up of the following fields:

| Field | Description |
| - | - |
| **Title** | The human-readable headline displayed at the top of the page and in search results. |
| **Body** | The main content area, authored in rich text or Markdown. Supports headings, lists, code blocks, images, tables, callouts, and embedded media. |
| **Category** | The category (or sub-category) the article belongs to, which determines where it appears in the sidebar. |
| **Author** | The team member who created or last edited the article, shown in the article byline. |
| **Tags** | Free-form labels for internal organization and improved AI search relevance. |
| **SEO Metadata** | A custom meta title and meta description that override the defaults in search engine results. |

## Article States

Every article passes through one or more lifecycle states. Nulix uses these states to keep unpublished drafts safely separate from live content.

> **Draft**
>
> A **Draft** article is a work in progress. It is only visible to workspace members with editor or admin access — readers browsing your knowledge base cannot see it. Use the Draft state whenever you are writing new content or making substantial edits to an existing article.

> **Published**
>
> A **Published** article is live and visible to your intended audience. The moment you publish, the article appears in the knowledge base sidebar, becomes indexable by search engines (if your KB is public), and surfaces in Nulix AI Search results. You can edit a published article at any time; changes take effect immediately.

> **Archived**
>
> An **Archived** article is hidden from readers and removed from navigation and search, but it is never deleted. Archiving is the right choice when content is outdated but you want to keep the revision history for reference or compliance. You can restore an archived article to Draft or Published status at any time.

## Revision History

Nulix automatically saves a revision every time an article is updated. You can view the full revision history from the article editor by clicking **History** in the top toolbar. Each revision records:

* The timestamp of the change
* The team member who made the edit
* A diff view comparing the revision to the current version

To restore a previous version, open that revision and click **Restore**. The restored content becomes a new revision rather than overwriting the history, so nothing is ever lost.

> [!TIP]
>
> The Nulix editor supports standard **Markdown shortcuts** inline. Type `##` followed by a space to create a heading, `**text**` for bold, or a triple backtick to open a code block — no toolbar click required.

## Next Steps

> **[Creating Articles](https://docs.nulix.io/publishing/creating-articles.md)**
>
> Follow the step-by-step guide to draft, format, and publish your first article in Nulix.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.