Quickstart #

This guide will walk you through creating a documentation site from scratch.

1. Create a Project Directory #

mkdir my-docs

cd my-docs

2. Initialize undox #

undox init

This creates:

  • undox.yaml - your site configuration
  • content/ - where your documentation lives
  • content/index.md - your homepage

3. Build Your Site #

undox build

Your site is now in _site/. Open _site/index.html in a browser to see it!

4. Add More Pages #

Create new markdown files in the content/ directory:

mkdir -p content/guide

Create content/guide/introduction.md:

---

title: Introduction

---



# Introduction



Welcome to the guide!

Rebuild and your new page appears in the sidebar automatically.

Project Structure #

After setup, your project looks like this:

my-docs/

  undox.yaml          # Site configuration

  content/

    index.md          # Homepage

    guide/

      introduction.md # Nested pages become sections

  _site/              # Built output (don't edit)

What's Next? #