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

# Citations & Bibliography

> Inline citations with page, chapter, and volume locators, author suppression, narrative mode, and automatic bibliography generation.

Autype supports academic-style inline citations and automatic bibliography generation.

## Inline citations

Use `@[citeKey]` to insert a citation:

```markdown theme={null}
This has been shown in previous research @[smith2023].
```

### Citations with locators

Add page numbers, chapters, sections, or volumes after the cite key:

```markdown theme={null}
@[smith2023, p. 42]
@[smith2023, pp. 42-45]
@[smith2023, ch. 3]
@[smith2023, sec. 2.1]
@[smith2023, vol. 2]
```

**Supported locator prefixes:**

| Prefix | Full form | Description    |
| ------ | --------- | -------------- |
| `p.`   | `page`    | Single page    |
| `pp.`  | `pages`   | Page range     |
| `ch.`  | `chapter` | Chapter number |
| `sec.` | `section` | Section number |
| `vol.` | `volume`  | Volume number  |

### Combining locators

Multiple locators can be combined with commas:

```markdown theme={null}
@[smith2023, vol. 2, pp. 42-45]
@[smith2023, ch. 3, p. 15]
```

### Adding notes

Add a custom note to a citation:

```markdown theme={null}
@[smith2023, p. 42, note="emphasis added"]
@[jones2022, note="translated by the author"]
```

***

## Author control

### Suppress author

Prefix the cite key with `-` to suppress the author name (useful when the author is already mentioned in the text):

```markdown theme={null}
Smith @[-smith2023, p. 42] showed that...
```

This renders as: Smith (2023, p. 42) instead of Smith (Smith, 2023, p. 42).

### Author only (narrative mode)

Append `!` to the cite key to show only the author name:

```markdown theme={null}
@[smith2023!] showed that the effect is significant @[smith2023, p. 42].
```

This renders as: Smith showed that the effect is significant (Smith, 2023, p. 42).

***

## Citations inside formatted text

Citations work inside bold, italic, and other formatting marks:

```markdown theme={null}
**This is important @[smith2023, p. 42].**
*As noted by @[jones2022!], the results are clear.*
```

***

## Bibliography

Generate an automatic bibliography from all citations in the document:

```markdown theme={null}
::bibliography{title="References"}
```

**Short aliases:**

```markdown theme={null}
::bib{title="References"}
::references{title="Literaturverzeichnis"}
```

The bibliography collects all cited sources and formats them according to the configured citation style.

### Attribute reference

| Attribute | Values | Description                            |
| --------- | ------ | -------------------------------------- |
| `title`   | String | Title displayed above the bibliography |

<Note>
  The bibliography only includes sources that are actually cited in the document. Uncited sources from your library are not included.
</Note>

***

## Full example

```markdown theme={null}
# Introduction

The relationship between X and Y has been studied extensively
@[smith2023, pp. 1-15]. @[jones2022!] provided a comprehensive
overview of the field, while @[-doe2021, ch. 3] focused specifically
on the methodology.

As **Smith @[-smith2023, p. 42]** noted, the effect size is
significant. This aligns with earlier findings @[brown2020, vol. 2, p. 88].

# References

::bibliography{title="References"}
```