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

# Card Formats

## Markdown

All card types support most markdown features including:

* **Bold text** with `**word**`
* *Italicizing* with `*word*`
* Inline maths, like $a^2 + b^2 = c^2$, by surrounding MathJax or LaTeX equations with `$...$`
* Code blocks, like `print("Hello, world!")`, by surrounding with backticks.

For a guide on markdown generally, you can take a look at this [guide](https://guides.github.com/features/mastering-markdown/)

## Card Types

Currently, Janus supports two card types: **Question & Answer** (Q\&A) and **Cloze cards**.

### Q\&A

You can make a Q\&A card by separating the front-side (question) and the back-side (answer) using three dashes (`---`).

For example:

```
What is the capital of France?
---
Paris
```

### Cloze

A cloze is a kind of **fill in the blank** card; the blank is referred to as the **deletion**. The front-side will show the text with blanks and then the back-side will fill in the blanks for you.

### Simple Deletions:

To create a deletion, hide the text in two curly braces (i.e. `{{..}}`).

For example:

```
The top three largest countries in the world are {{Russia}}, {{Canada}} and {{China}}
```

has **front-side**

```
The top three largest countries in the world are ______, ______ and ______
```

and **back-side**:

```
The top three largest countries in the world are Russia, Canada and China
```

<Note>
  When a card only uses simple deletions, Janus automatically groups them together as group 1.
</Note>

### Grouped Deletions

Deletions may be grouped together. Each grouping will give a variation of the flashcard where the front-side hides **only that group**.

To group deletions, specify the grouping by adding the index at the start, followed by two colons (i.e. `{{1::...}}`)

For example

```
{{1::France}} had a population of {{2::68 million}} in {{3::2024}}
```

is a cloze card with 3 groups. When tested, you will see one of:

* `_____ had a population of 68 million in 2024`
* `France had a population of _____ in 2024`
* `France had a population of 68 million in _____`