Quarto

¿Que es Quarto?

Quarto Markdown es una forma de agregar formatos como encabezados, negritas, cursivas, listas… a un texto sin formato. En principio se creó como una alternativa a HTML más simple, y que gente sin mucho conocimiento de este lenguaje de programación pudiese crear páginas web. Pero con el tiempo, se convirtió en un sistema de escritura minimalista con el que poder escribir sin muchas preocupaciones, y que puede ser exportados a otros sitios con facilidad.

Al tener una sintaxis más simple que HTML, es mucho más sencillo de aprender. No hay que preocuparse por ir abriendo y cerrando tags. Y como no tiene los típicos menús contextuales de los editores de texto clásicos, se puede escribir en un entorno con menos distracciones. Ideal para aquellos que pasan mucho de su tiempo escribiendo textos.

¿Por qué debería incorporarlo a mi flujo de trabajo?

Si escribes habitualmente para algún sitio web, ya sea en tu sitio personal o un medio periodístico, por ejemplo, Markdown es un gran aliado. Pero no solo eso. Aquí tienes algunas de las cosas que podrás hacer con Markdown:

• Escribir emails con un formato determinado, y no tener que hacerlo dentro de la aplicación de correo.
• Crear listas To-Do, ya que cualquier programa especializado en esta tarea lee este tipo de archivos.
• Crear y organizar notas.

Y , por supuesto, poder escribir en una web sin tener conocimientos de HTML. Desde el punto de vista de la productividad, quarto es muy útil porque se centra en lo importante: la escritura.Una vez aprendas a usarlo, podrás dar formato a tus textos sin tener que tocar el ratón. No tendrás que separar nunca más las manos del teclado.

OJS:

OJS code cells {ojs} behave a bit differently than cells in traditional notebooks, and have many options available to control their display and layout.

Observable is a platform for publishing and sharing interactive data-driven documents, an online editor for composing, cells are executed in a sequence, with outputs being generated and displayed as part of the notebook, changes made to cells can be re-executed, updated in real-time.

Example 2: Histiogram

• link

height = 250
numbers = Float64Array.from({length: 1000}, d3.randomNormal())
import {chart as histogram} with {numbers as data, height} from "@d3/histogram@261"
histogram

Ejemplos de sintaxis

Lo que sigue no es un listado exhaustivo de la ]sintaxis de Quarto. En muchos casos, se puede conseguir un efecto particular usando diferentes estilos de sintaxis.

Los caracteres que serían interpretados por quarto como comandos de formateado se interpretan literalmente si se precede por una barra invertida; por ejemplo la secuencia ‘*’ mostraría un asterisco en lugar de empezar una sección de texto enfatizado. Un bloque de HTML crudo no se verá alterado por quarto, pero los comandos de quarto insertados dentro de un elemento de bloque de HTML crudo no serán procesados.

1. Saltos de línea: Los saltos de línea se generan cuando se encuentran dos espacios juntos, ejemplo:

“Quien fue a Santiago,
perdió su clase de redes”

2. Encabezados: Los encabezados se generan cuando se encuentra una almohadilla antes de texto, ejemplo:

h1

h2

h3

h4

h5

h6

3. Citas: Para citar solo es necesario escribir una cuña antes del texto, ejemplo:

La vida es muy corta para aprender alemán. -Tad Marburg

4. Texto con énfasis: Agregar un asterisco para cursiva y dos para negrita, ejemplo:

• énfasis (cursiva)

• énfasis fuerte (negrita)

5. Código: Se utiliza el acento grave para identificar código, y corchetes para identificar el lenguaje de programación, ejemplo:

Código

Código en 
varias líneas

6. Listas:

• Un elemento en una lista no ordenada
• Otro elemento en una lista

1. Elemento en una lista enumerada u ordenada.
2. Otro elemento

7. Enlaces:

Enlace en Quarto

8. Imágenes:

![(img/elephant.png){width=“40%”}}

9. Table:

• tables
• tablesgenerator

#| tables
| Default | Left | Right | Center |
|---------|:-----|------:|:------:|
| 12      | 12   |    12 |   12   |
| 123     | 123  |   123 |  123   |
| 1       | 1    |     1 |   1    |
: Demonstration of pipe table syntax
: Callouts looks {tbl-colwidths="[20,85]"}

11. Callouts:

::: {.callout-note}
Note that there are five types of callouts, including:
`note`, `warning`, `important`, `tip`, and `caution`.
:::
::: {.callout-tip}
## Tip With Caption
This is an example of a callout with a caption.
:::
::: {.callout-caution collapse="true"}
## Expand To Learn About Collapse
This is an example of a 'folded' caution callout that can be expanded by the user.
You can use `collapse="true"` to collapse it by default or `collapse="false"` to make 
a collapsible callout that is expanded by default.
:::

callouts

Pay Attention

Using callouts is an effective way to highlight content that your reader give special consideration or attention.

Tip

12. Mermaid:

Mermaid is a Javascript based diagramming and charting tool that uses Markdown-inspired text definitions and a renderer to create and modify complex diagrams.

Above we demonstrated a flowchart created with Mermaid, here is a sequence diagram (also embedded using a {mermaid} executable cell):

For example, here we embed a flowchart created using Mermaid:

{mermaid} flowchart LR A[Hard edge] –> B(Round edge) B –> C{Decision} C –> D[Result one] C –> E[Result two]

flowchart LR
  A[Hard edge] --> B(Round edge)
  B --> C{Decision}
  C --> D[Result one]
  C --> E[Result two]

13. Listing-Table:

Listings enable you to automatically generate the contents of a page (or region of a page) from a list of Quarto documents or other custom data. You can enable listings on a page using the listing option in the document front matter, for example: