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

# Wiki

> Wiki validates, queries, and publishes semantic Markdown wikis.

Wiki is a command-line system for Markdown wikis. You keep writing in Obsidian,
VS Code, or any editor, then use the CLI to validate documents, run semantic
queries, render derived content, and build static sites.

## What it does

* **Trust**: `check`, `lint`, and `fmt` validate frontmatter, links, shapes, and
  conventions.
* **Intelligence**: `query`, `render`, and `export` turn Markdown into queryable
  semantic data.
* **Publish**: `build`, `serve`, and `link` support static site workflows and
  wikilink hygiene.

## Live demo and example wiki

Explore the live Wikipedia-styled template demo powered by Wiki at
[wiki.wazoo.dev/wiki](https://wiki.wazoo.dev/wiki/).

## Use cases

* Personal knowledge management and Obsidian vaults.
* Internal company wikis.
* LLM memory wikis maintained by agents.
* Static documentation sites backed by semantic Markdown.

## Repositories

| Repository                                                    | Purpose                                               |
| ------------------------------------------------------------- | ----------------------------------------------------- |
| [wiki](https://github.com/wazootech/wiki)                     | CLI, Python package, docs, and core implementation    |
| [wiki-templates](https://github.com/wazootech/wiki-templates) | Starter workspaces: `generic`, `llm-wiki`, `mintlify` |

## Programmatic integration

Wiki ships as an embeddable Python library and a TypeScript SDK backed by the
same CLI engine.

### Python

```python theme={null}
from wazootech_wiki import Wiki

wiki = Wiki("./my-vault")
wiki.check(strict=True)
wiki.build()
```

### TypeScript

```typescript theme={null}
import { Wiki } from "wazootech-wiki";

const wiki = Wiki.load({ config: "wiki.yaml" });

await wiki.check({ strict: true });
await wiki.build();
```

## Install

<CodeGroup>
  ```bash pip theme={null}
  pip install wazootech-wiki
  wiki --help
  ```

  ```bash npm theme={null}
  npx wazootech-wiki --help
  ```

  ```bash pnpm theme={null}
  pnpm dlx wazootech-wiki --help
  ```

  ```bash yarn theme={null}
  yarn dlx wazootech-wiki --help
  ```

  ```bash bun theme={null}
  bunx wazootech-wiki --help
  ```
</CodeGroup>

## Quickstart

Initialize a wiki, validate it, then preview it locally:

```bash theme={null}
wiki init
wiki check --strict
wiki serve --watch
```

## Templates

Starter workspaces live in the
[wiki-templates](https://github.com/wazootech/wiki-templates) repository,
including `generic`, `llm-wiki`, `mintlify`, `quartz`, and `yasgui`. The
`wiki init` command scaffolds a local starter workspace directly.

Propose a new template or integration by opening an issue on the
[wiki-templates repository](https://github.com/wazootech/wiki-templates).

## Learn more

* [Live Wiki Example](https://wiki.wazoo.dev/wiki/)
* [Wiki repository](https://github.com/wazootech/wiki)