Skip to content
Documentation

Documentation · Chapter 1

Get started

Install Zensical, learn the core commands, and see admonitions, code blocks, tabs, and diagrams in action.

Published Jul 18, 2026

What a documentation toolchain actually is, once you strip away the marketing: Markdown in, a readable site out, plus the loop that ties authoring and preview together.

Where we're going

Zensical turns plain Markdown into a documentation site. This chapter covers the commands you need day to day, then walks through the authoring features you will reach for first.

For full documentation visit zensical.org.

Commands

Admonitions

Go to documentation

Note

This is a note admonition. Use it to provide helpful information.

Warning

This is a warning admonition. Be careful!

Details

Go to documentation

Click to expand for more info

This content is hidden until you click to expand it. Great for FAQs or long explanations.

Code blocks

Go to documentation

Code blocks
def greet(name):
    print(f"Hello, {name}!") # (1)!

greet("Python")

  1. Go to documentation

    Code annotations allow you to attach notes to lines of code.

Code can also be highlighted inline: print("Hello, Python!").

Content tabs

Go to documentation

print("Hello from Python!")

println!("Hello from Rust!");

Diagrams

Go to documentation

graph LR
  A[Start] --> B{Error?};
  B -->|Yes| C[Hmm...];
  C --> D[Debug];
  D --> B;
  B ---->|No| E[Yay!];