Fundamental Blocks

Inside Tachyonn, every piece of content on a slide is a block. A heading is a block, a paragraph is a block, a list is a block, an image is a block. You don't declare these explicitly — Tachyonn recognizes them from the way you write. This page is a friendly tour of the blocks you'll use most.

Headings

Headings do double duty: they create slides and they title them.

# A section divider
## A content slide
### A heading inside the current slide

As a rule of thumb: # for chapters, ## for slides, ###+ for structure within a slide. You can have up to six levels (######).

Paragraphs

A paragraph is just text. Leave a blank line between paragraphs to keep them separate:

This is one paragraph. It can be as long as you like and it will
wrap naturally on the slide.

This is a second paragraph, separated by a blank line.

Text formatting

You can emphasize words inline. These work anywhere text appears:

You type	You get
**bold**	bold
*italic*	italic
***bold italic***	bold italic
~~strikethrough~~	strikethrough
`code`	code

Lists

Bulleted lists start each line with -, *, or +. Numbered lists start with a digit and a dot. Indent to create sub-items:

- A point
- Another point
  - A sub-point

1. First
2. Second

Images

Drop in an image with ![path], optionally followed by a caption:

![<c> chart.png, Figure 1: quarterly results]

The <c> is a modifier that centers the image. There are more modifiers for alignment and sizing — see the Images reference.

Quotes

Start a line with > for a block quote. Add an attribution on the next line with an em dash:

> The best way to predict the future is to invent it.
— Alan Kay

Code

Fence a code block with triple backticks and name the language for syntax highlighting:

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

Putting it together

Here's a single slide that uses several blocks at once:

## A little of everything

A short intro paragraph that sets up the slide.

- A key point in **bold**
- A point with some `inline code`

```js
console.log("and a code sample")

Each block stacks neatly on the slide, in the order you wrote it. You focus on the content; Tachyonn handles the spacing and arrangement.

When you're comfortable here, the [Syntax Guide](../guide/) goes through every block type in full detail.