# Markdown

### Headings

To create a heading, add one to six `#` symbols before your heading text. The number of `#` you use will determine the hierarchy level and typeface size of the heading.

```markdown
# A first-level heading
## A second-level heading
### A third-level heading
```

### Styling text

You can indicate emphasis with bold, italic, strikethrough, subscript, or superscript text.

| Style                  | Syntax             | Example                                  | Output                                                   |
| ---------------------- | ------------------ | ---------------------------------------- | -------------------------------------------------------- |
| Bold                   | `** **` or `__ __` | `**This is bold text**`                  | **This is bold text**                                    |
| Italic                 | `* *` or `_ _`     | `_This text is italicized_`              | *This text is italicized*                                |
| Strikethrough          | `~~ ~~`            | `~~This was mistaken text~~`             | ~~This was mistaken text~~                               |
| Bold and nested italic | `** **` and `_ _`  | `**This text is _extremely_ important**` | **This text is *****extremely***** important** |
| All bold and italic    | `*** ***`          | `***All this text is important***`       | ***All this text is important***                         |

### Quoting text

You can quote text with a `>`.

```markdown
Text that is not a quote

> Text that is a quote
```

Quoted text is indented.

### Quoting code

You can call out code or a command within a sentence with single backticks. The text within the backticks will not be formatted.

```markdown
Use `cat file.txt` to output the content of the text file.
```

To format code into its own distinct block, use triple backticks.

````markdown
Print a text string:

```
print("Hello World!")
```
````

Spacehall will try to infer the programming language from the block's content.

You can also set it manually by adding the language name after the first backticks.

````markdown
Print a text string:

```rust
println!("Hello World!")
```
````

### Links

You can create an inline link by wrapping link text in brackets `[ ]`, and then wrapping the URL in parentheses `( )`.

```markdown
This discussion is hosted on [Spacehall](https://spacehall.app).
```

Valid URLs are automatically transformed as links.

### Images

You can display an image by adding ! and wrapping the alt text in \[ ].

Alt text is a short text equivalent of the information in the image.

Then, wrap the link for the image in parentheses ().

```markdown
![My screenshot](https://some-url.com/my-screenshot.jpg)
```

For more information on how to upload a picture to Spacehall, see Uploading assets.

### Lists

You can make an unordered list by preceding one or more lines of text with `-`, `*`, or `+`.

```markdown
- George Washington
- John Adams
- Thomas Jefferson
```

To order your list, precede each line with a number.

```markdown
1. James Madison
1. James Monroe
1. John Quincy Adams
```

#### Nested Lists

You can create a nested list by indenting one or more list items below another item.

```markdown
1. First list item
   - First nested list item
     - Second nested list item
```

### Task lists

You can create a task list by preceding one or more line with `- [ ]` for new tasks, and `- [x]` for completed tasks.

```markdown
- [x] buy bread
- [ ] buy cheese
- [ ] buy ham
```

### Uploading assets

You can upload assets like images by using the file uploader.

| Limitations           |                                    |
| --------------------- | ---------------------------------- |
| Supported assets      | images                             |
| Format                | jpeg, png, svg, gif, webp          |
| Maximum size          | 10 MB                              |
| Maximum dimension     | 12,000 px                          |
| Maximum resolution    | 100 megapixels (ex: 10,000x10,000) |
| Maximum metadata size | 1024 bytes                         |
| Animated GIFs         | Limited to 50 mp                   |

### Paragraphs

You can create a new paragraph by leaving a blank line between lines of text.

### Footnotes

You can add footnotes to your content by using this bracket syntax:

```markdown
Here is a simple footnote[^1].

A footnote can also have multiple lines[^2].

[^1]: My reference.
[^2]: To add line breaks within a footnote, prefix new lines with 2 spaces.
  This is a second line.
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.spacehall.app/references/markdown.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.