Usage

Start with these tokens when customizing references:

--reference-spacing for vertical rhythm in bibliographies

--reference-font-size and --reference-line-height for readability

--reference-text-indent plus --reference-padding-left for hanging indents

--reference-text-align and --reference-hyphens for layout style

Pair a negative --reference-text-indent with a matching positive --reference-padding-left to create hanging indents without overflow. Spacing derives from --content-spacing for responsive rhythm.

Tokens

Spacing and Typography Tokens

Reference-specific controls for spacing, typography, alignment, and text flow in bibliographies and reference lists.

Token	Description	Default Value
`--reference-spacing`	Reference spacing (responsive)	`var(--content-spacing)`
`--reference-font-size`	Font size for reference text	`var(--text-font-size)`
`--reference-line-height`	Line height within references	`var(--text-line-height)`
`--reference-text-align`	Text alignment (left, right, center, justify)	`left`
`--reference-text-indent`	Text indentation (negative for hanging indent)	`0`
`--reference-padding-left`	Left padding (should match negative indent)	`0`
`--reference-hyphens`	Hyphenation control (none, auto, manual)	`none`

Examples

Default References

Standard reference styling with automatic responsive spacing and typography:

:root {
  /* No design token overrides */
}

``````````html raw

Anderson, J., Brown, K., & Chen, L. (2024). Novel approaches to quantum computing in molecular simulations. Journal of Computational Science, 42(7), 1234-1250. https://doi.org/10.1000/jcs.2024.001

Martinez, R., Thompson, S., & Wilson, P. (2023). Deep learning architectures for predictive modeling in biological systems. Advances in Neural Networks, 18(4), 567-589. https://doi.org/10.1000/ann.2023.045

Lee, H., Patel, N., & Davis, M. (2024). Real-time data processing frameworks for large-scale scientific computing. Computing Methods Review, 31(2), 89-112. https://doi.org/10.1000/cmr.2024.078


:::

## Dense Bibliography

Compact spacing and smaller font for space-efficient reference sections:

```css
:root {
  --reference-spacing: var(--space-3);
  --reference-font-size: var(--font-size-sm);
  --reference-line-height: var(--line-height-sm);
}

``````````html raw

Anderson, J., Brown, K., & Chen, L. (2024). Novel approaches to quantum computing in molecular simulations. Journal of Computational Science, 42(7), 1234-1250. https://doi.org/10.1000/jcs.2024.001

Martinez, R., Thompson, S., & Wilson, P. (2023). Deep learning architectures for predictive modeling in biological systems. Advances in Neural Networks, 18(4), 567-589. https://doi.org/10.1000/ann.2023.045

Lee, H., Patel, N., & Davis, M. (2024). Real-time data processing frameworks for large-scale scientific computing. Computing Methods Review, 31(2), 89-112. https://doi.org/10.1000/cmr.2024.078


:::

## Hanging Indent Style

Traditional bibliography formatting with hanging indents:

```css
:root {
  --reference-spacing: var(--space-4);
  --reference-text-indent: -1.5em;
  --reference-padding-left: 1.5em;
}

``````````html raw

Anderson, J., Brown, K., & Chen, L. (2024). Novel approaches to quantum computing in molecular simulations. Journal of Computational Science, 42(7), 1234-1250. https://doi.org/10.1000/jcs.2024.001

Martinez, R., Thompson, S., & Wilson, P. (2023). Deep learning architectures for predictive modeling in biological systems. Advances in Neural Networks, 18(4), 567-589. https://doi.org/10.1000/ann.2023.045

Lee, H., Patel, N., & Davis, M. (2024). Real-time data processing frameworks for large-scale scientific computing. Computing Methods Review, 31(2), 89-112. https://doi.org/10.1000/cmr.2024.078


:::

## Justified Dense Bibliography

Scholarly paper style with justified text and hyphenation:

```css
:root {
  --reference-spacing: var(--space-3);
  --reference-font-size: var(--font-size-sm);
  --reference-text-align: justify;
  --reference-text-indent: -1.5em;
  --reference-padding-left: 1.5em;
  --reference-hyphens: auto;
}

``````````html raw

Anderson, J., Brown, K., & Chen, L. (2024). Novel approaches to quantum computing in molecular simulations. Journal of Computational Science, 42(7), 1234-1250. https://doi.org/10.1000/jcs.2024.001

Martinez, R., Thompson, S., & Wilson, P. (2023). Deep learning architectures for predictive modeling in biological systems. Advances in Neural Networks, 18(4), 567-589. https://doi.org/10.1000/ann.2023.045

Lee, H., Patel, N., & Davis, M. (2024). Real-time data processing frameworks for large-scale scientific computing. Computing Methods Review, 31(2), 89-112. https://doi.org/10.1000/cmr.2024.078


:::

## Spacious References

Generous spacing for enhanced readability in presentations or educational materials:

```css
:root {
  --reference-spacing: var(--space-8);
  --reference-line-height: var(--line-height-md);
  --reference-text-wrap: pretty;
}

``````````html raw

Anderson, J., Brown, K., & Chen, L. (2024). Novel approaches to quantum computing in molecular simulations. Journal of Computational Science, 42(7), 1234-1250. https://doi.org/10.1000/jcs.2024.001

Martinez, R., Thompson, S., & Wilson, P. (2023). Deep learning architectures for predictive modeling in biological systems. Advances in Neural Networks, 18(4), 567-589. https://doi.org/10.1000/ann.2023.045

Lee, H., Patel, N., & Davis, M. (2024). Real-time data processing frameworks for large-scale scientific computing. Computing Methods Review, 31(2), 89-112. https://doi.org/10.1000/cmr.2024.078


:::

# Tips

**Hanging indents**: Pair negative `--reference-text-indent` with matching `--reference-padding-left`.

**Justified lists**: Use `--reference-text-align: justify` with `--reference-hyphens: auto` for dense bibliographies.

**Long URLs**: Enable `--reference-text-wrap: pretty` to improve line breaks for DOI/URL-heavy entries.

**Page breaks**: Tune `--reference-orphans` and `--reference-widows` to control splits in print output.

© 2026 Stencila