---
icon: lucide/rocket
---
# Welcome!

For full documentation visit [zensical.org](https://zensical.org/docs/).

## Commands

- `zensical new` - Create a new project
- `zensical serve` - Start local web server
- `zensical build` - Build your site

## [[markdown]]

## Examples

### Admonitions

> Go to [documentation](https://zensical.org/docs/authoring/admonitions/)

!!! note

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

!!! warning

```text
This is a **warning** admonition. Be careful!
```

### Details

> Go to [documentation](https://zensical.org/docs/authoring/admonitions/#collapsible-blocks)

??? info "Click to expand for more info"

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

## Code Blocks

> Go to [documentation](https://zensical.org/docs/authoring/code-blocks/)

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

greet("Python")
```

1. Go to [documentation](https://zensical.org/docs/authoring/code-blocks/#code-annotations)

Code annotations allow to attach notes to lines of code.

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

## Content tabs

> Go to [documentation](https://zensical.org/docs/authoring/content-tabs/)

=== "Python"

````text
``` python
print("Hello from Python!")
```
````

=== "Rust"

````text
``` rs
println!("Hello from Rust!");
```
````

## Diagrams

> Go to [documentation](https://zensical.org/docs/authoring/diagrams/)

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

## Footnotes

> Go to [documentation](https://zensical.org/docs/authoring/footnotes/)

Here's a sentence with a footnote.[1](#user-content-fn-1)

Hover it, to see a tooltip.

## Formatting

> Go to [documentation](https://zensical.org/docs/authoring/formatting/)

- ==This was marked (highlight)==
- ^^This was inserted (underline)^^
- ~~This was deleted (strikethrough)~~
- H~~2~~O
- A^T^A
- ++ctrl+alt+del++

## Icons, Emojis

> Go to [documentation](https://zensical.org/docs/authoring/icons-emojis/)

- :sparkles: `:sparkles:`
- :rocket: `:rocket:`
- :tada: `:tada:`
- :memo: `:memo:`
- :eyes: `:eyes:`

## Maths

> Go to [documentation](https://zensical.org/docs/authoring/math/)

$$
\cos x=\sum_{k=0}^{\infty}\frac{(-1)^k}{(2k)!}x^{2k}
$$

!!! warning "Needs configuration"\
Note that MathJax is included via a `script` tag on this page and is not\
configured in the generated default configuration to avoid including it\
in a pages that do not need it. See the documentation for details on how\
to configure it on all your pages if they are more Maths-heavy than these\
simple starter pages.

## Task Lists

> Go to [documentation](https://zensical.org/docs/authoring/lists/#using-task-lists)

- [x] Install Zensical
- [x] Configure `zensical.toml`
- [x] Write amazing documentation
- [ ] Deploy anywhere

## Tooltips

> Go to [documentation](https://zensical.org/docs/authoring/tooltips/)

[Hover me](https://example.com)

## Footnotes

1. This is the footnote. [↩](#user-content-fnref-1)