Opciones del formato Typst en Quarto

Pedro L. Luque (29-08-2025)

1 Opciones universales de Quarto

Estas son opciones universales de Quarto que funcionan en todos los formatos de salida (HTML, PDF, Word, etc.)

1.1 Información del Documento

• title (string) - Título del Documento [Documentación en: Quarto]
  • Ejemplo: title: "My Paper"
• author (string/array) - Detalles del autor con nombre, afiliación, correo electrónico, etc. [Quarto]
• affiliations (array) - Afiliaciones de autores con: id, name, department [Quarto]
• subtitle (string) - Subtítulo del Documento [Quarto]
  • Ejemplo: subtitle: "A Study"
• abstract (string) - Resumen del Documento [Quarto]
  • Ejemplo: abstract: "This study..."
• categories (array) - Keywords/categories para el documento [Quarto]
  • Ejemplo: categories: ["science", "study"]
• date (string) - Fecha de Publicación [Quarto]
  • Ejemplo: date: "2024-01-21"
• toc (boolean) - Incluye la tabla de contenido [Quarto]
  • Ejemplo: toc: true
• toc-title (string) - Personaliza el título de la tabla de contenido [Quarto]
  • Ejemplo: toc-title: "Contenido"
• toc-depth (integer) - Número de niveles de secciones en el TOC [Quarto]
  • Ejemplo: toc-depth: 2
• number-sections (boolean) - Numera las secciones [Quarto]
  • Ejemplo: number-sections: true

1.2 Bibliografía y Citaciones

• bibliography (string/array) - Fichero de Bibliografía [Quarto]
  • Ejemplo: bibliography: "bibliography.bib"
• csl (string) - Fichero del Lenguaje de Estilo de Citación or URL [Quarto]
  • Ejemplo: csl: https://www.zotero.org/styles/apa o csl: apa.csl

• citeproc (boolean; Tip 1) - Usa el proceso de citación de Pandoc (no el de Quarto) [Quarto]
  • Ejemplo: citeproc: true

Nota 1: Quarto, Typst, y procesamiento de bibliografía

Typst tiene su propio sistema de citación, pero por defecto la extensión lo desactiva al usar citeproc: true para permitir la personalización mejor de la bibliografía y el uso de la de Quarto Documentación: “Citaciones en Quarto”. En su documento, incluya:

# References

::: {#refs}
:::

para mostrar la sección de bibliografía en cualquier parte del documento. Lea más en la documentación de citaciones de Quarto.

• Cuando citeproc esta desactivado (citeproc: false)
  • bibliography-title (string) - título de la sección de Bibliografía
    • Ejemplo: bibliography-title: "Referencias"
  • bibliographystyle (string) - Estilo de Citación [Quarto, Typst]
    • Ejemplo: bibliographystyle: "apa"

1.3 Tipografía y fuentes

• fontsize (string) - Tamaño de la Fuente Base para el texto del Documento [Quarto]
  • Ejemplo: fontsize: "11pt"
• mainfont (string) - Fuente Principal del Documento [Quarto]
  • Ejemplo: mainfont: "Libertinus Serif"
• monofont (string) - Familia de Fuentes para el Código [Quarto]
  • Ejemplo: monofont: "Monacy"
  • Nota: Actualmente no funciona (Quarto issue)
• linkcolor (string) - Color para hiperenlaces [Quarto, Typst]
  • Ejemplo: linkcolor: "blue" o linkcolor: "#0066cc"
• font-paths (array) - Directorios Adicionales para Búsqueda de Fuentes [Quarto]
  • Ejemplo: font-paths: ["myfonts"]

1.4 Idiomas y localización

• lang (string) - Idioma del Documento [Quarto]
  • Ejemplo: lang: "es" (español) or lang: "en" (inglés)
• region (string) - Región del Documento [Quarto]
  • Ejemplo: region: "US" or region: "GB"

1.5 Figuras

• fig-format (string) - Formato de Salida de las Figuras [Quarto]
  • Ejemplo: fig-format: "png" (Recomendado) o fig-format: "svg"

2 Opciones para Typst en Quarto

Estas opciones funcionan en los formatos de salida Typst de Quarto pero pueden no funcionar en HTML, Word, etc.

2.1 Formato de Páginas

• papersize (string) - Page size specification [Quarto]
  • Ejemplo: papersize: a4
• margin (object/string) - Márgenes de Página [Quarto]
  • Ejemplo: margin: {x: 2.8cm, y: 2.6cm}
• columns (integer) - Número de columnas de contenido [Quarto]
  • Ejemplo: columns: 2
• page-numbering (string) - Modelo de Numeración de Páginas [Typst]
  • Ejemplo: page-numbering: "1" o page-numbering: "i"

2.2 Numberaración de Secciones

• section-numbering (string) - Modelo de Numeración de las Secciones [Quarto]
  • Ejemplo: section-numbering: "1.1.a" o section-numbering: "1.A.a"

3 Cabecera yaml de Quarto-Typst

Coloca código Typst personalizado en la cabecera YAML del documento Quarto (format: typst) que se insertará en el encabezado o antes del cuerpo del documento. Por ejemplo, en este documento se han usado estas opciones,

• para cambiar el color de fondo de la página, para indentar la primera línea de los párrafos, para ajustar el espacio entre columnas,

• el color de las secciones y los hiperenlaces, el formato de numeración de las secciones, el color de las citas y los enlaces, la numeración de todas las líneas del documento (para revisión), la justificación del texto, el espacio entre líneas (leading) y párrafos (spacing), indentación de primera línea (first-line-indent para el primer párrafo o todos), se puede usar:

include-in-header: 
    - text: |                    
        #set page(fill: rgb("FFFFE9"))
        #set par(first-line-indent: 1.5em)
        #set columns(gutter: 2em) // o 4.2%
include-before-body:
    - text: |
        #show heading: set text(rgb("0066cc"))  
        #set heading(numbering: "(1.A)")
        #show link: set text(fill: blue)
        #show cite: set text(fill: blue)
        //#set par.line(numbering: "1")
        #set par(justify: true, leading: 0.5em, 
            spacing: 0.8em, first-line-indent: 
            (amount: 1.8em, all: true))