Escribe en Markdown

Markdown funciona bien para notas de investigación, informes y primeros borradores. Oleafly le da una barra de formato propia y una ruta de compilación con Pandoc, con archivos de código que puedes usar fuera de la app.

Crea un informe

1. Elige Proyecto nuevo → Usar una plantilla → Blank Markdown document.
2. Ponle al proyecto el nombre Notas de campo y abre main.md.
3. Pega este ejemplo y elige Recompilar o pulsa ⌘Enter / Ctrl+Enter.
4. Si Oleafly se ofrece a configurar un motor necesario, completa esa configuración y vuelve a compilar.

main.md

---
title: "Field notes"
author: "Alex Chen"
date: ""
---

# Question

Does the revised procedure reduce measurement time?

## Method

1. Prepare the sample.
2. Repeat the measurement three times.
3. Record the elapsed time.

## Observations

| Run | Time (s) | Note |
| --- | --- | --- |
| 1 | 12 | First pass |
| 2 | 10 | Repeated pass |

The **mean time** will be compared with the baseline.

El PDF debería incluir un título, encabezados, una lista numerada y una tabla. Los metadatos entre el primer par de líneas --- controlan el título y el autor del documento.

Edición de código y edición visual

El interruptor del principio de la barra tiene tres modos. Código edita el Markdown directamente. Visual ofrece edición con formato para títulos, párrafos, listas, enlaces, imágenes y tablas. Ambos muestra a la vez el código y el texto con formato. Abre su menú para elegir Apilado o Dividir. Los proyectos nuevos se abren en Código y cada proyecto recuerda el modo en que lo dejaste.

Subrayado, resaltado, superíndice y subíndice son controles de formato de Pandoc en el modo Código. Sus botones se ocultan en el modo Visual. Usa Código cuando trabajes con metadatos, con la sintaxis de las citas o con otras construcciones del código.

Descarga el código del ejemplo

Todas las herramientas de la barra

Selecciona texto antes de hacer clic en un control de formato. En el modo Código, la mayoría de las herramientas envuelven la selección o insertan un marcador de posición. Abre Más opciones de formato (…) para llegar a los controles que no caben en la barra.

Código / Visual

Cambia entre Código, Visual y Ambos. El documento sigue siendo código de Markdown en todos los modos.

Deshacer

Revierte la última edición. ⌘Z / Ctrl+Z.

Rehacer

Restaura una edición deshecha. ⌘Shift+Z / Ctrl+Shift+Z.

Título → Título

Elige Título en el menú de títulos para insertar # Title. Sustituye el texto del título por el tuyo.

Título → Sección

Elige Sección en el menú de títulos para insertar ## Section. Sustituye el texto del título por el tuyo.

Título → Subsección

Elige Subsección en el menú de títulos para insertar ### Subsection. Sustituye el texto del título por el tuyo.

Título → Subsubsección

Elige Subsubsección en el menú de títulos para insertar #### Subsubsection. Sustituye el texto del título por el tuyo.

Título → Título menor

Elige Título menor en el menú de títulos para insertar ##### Minor heading. Sustituye el texto del título por el tuyo.

Título → Título de párrafo

Elige Título de párrafo en el menú de títulos para insertar ###### Paragraph heading. Sustituye el texto del título por el tuyo.

Lista con viñetas

Empieza una lista sin orden. - Item.

Lista numerada

Empieza una secuencia. 1. Item.

Lista de tareas

En el modo Código, añade una tarea y cambia [ ] por [x] cuando esté completa. - [ ] Task.

Cita en bloque

Coloca una cita en su propia línea. > quoted text.

Negrita

Da énfasis al texto seleccionado. **text**; ⌘B / Ctrl+B.

Cursiva

Da énfasis a un término. *text*; ⌘I / Ctrl+I.

Tachado

Marca un texto como sustituido. ~~text~~.

Código en línea

Da formato a un nombre de archivo, un comando o un identificador. Texto entre acentos graves.

Subrayado

Selecciona una frase en el modo Código. [text]{.underline}.

Resaltado

Selecciona una frase en el modo Código. [text]{.mark}.

Superíndice

Selecciona el exponente en el modo Código. ^text^.

Subíndice

Selecciona el subíndice en el modo Código. ~text~.

Subrayado y resaltado usan atributos de Pandoc para que el formato pueda llegar al PDF. Usa estos controles en lugar de añadir etiquetas HTML sin procesar al manuscrito.

Insertar un enlace

En el modo Código: inserta [link text](url). Sustituye los dos marcadores de posición.

En el modo Visual: abre URL del enlace. Escribe la dirección y aplícala a tu selección. Usa Quitar el enlace para conservar el texto sin el enlace.

Insertar una imagen

En el modo Código: inserta ![caption](image-filename). Sustituye la ruta y el pie.

En el modo Visual: abre Archivo de imagen. Escribe una ruta del proyecto, como figures/plot.png, y aplícala.

Insertar una tabla

En el modo Código: inserta tres columnas, un encabezado y dos filas de datos. Sustituye los nombres de las columnas y las celdas.

En el modo Visual: inserta una tabla editable con las mismas dimensiones iniciales.

Dibujar un diagrama

Abre el compositor de diagramas en modo Mermaid. Dibuja un diagrama de flujo en el lienzo o edita el código de Mermaid y luego elige Insertar como Mermaid para añadirlo en el cursor como un bloque de código mermaid delimitado. Consulta Diagramas de Mermaid.

Análisis del documento

Enumera los títulos, las figuras, las tablas, las ecuaciones, las etiquetas, las citas y las tareas pendientes del documento en el orden del código, cada uno enlazado con su línea. También lee el título, los autores, las palabras clave, la fecha y el resumen del front matter y puede copiarlos para un formulario de envío. Consulta Análisis del documento.

Ajustes del documento

Cambia la clase del documento, el tamaño de página, las columnas, los márgenes, la tipografía del texto, el tamaño de letra, el idioma, el interlineado y la numeración de las secciones. Oleafly escribe tus elecciones en el front matter en YAML que lee Pandoc y añade un bloque de front matter si el archivo no tiene ninguno. Consulta Ajustes del documento.

Información del proyecto

En el modo Código: muestra las estadísticas del proyecto y la información de la selección.

En el modo Visual: muestra las estadísticas de la superficie de edición visual.

Buscar

En el modo Código: abre la búsqueda del archivo activo con ⌘F / Ctrl+F.

En el modo Visual: el botón Buscar de la barra de código está oculto.

Importa la imagen a través del árbol de archivos antes de referenciarla. Mantén las rutas de las imágenes relativas al manuscrito, para que el archivo comprimido del código funcione en otro ordenador.

Ecuaciones y bloques de código

Escribe las fórmulas en línea como $x^2$. Pon una ecuación en bloque entre dos pares de signos de dólar:

$$
\bar{x} = \frac{1}{n}\sum_{i=1}^{n}x_i
$$

Para un ejemplo de código, encierra el código entre tres acentos graves y pon su lenguaje después de la valla de apertura. Son construcciones del código; la barra de Markdown no tiene un botón aparte para las ecuaciones ni para los bloques de código delimitados.

Diagramas de Mermaid

Elige Dibujar un diagrama en la barra para crear un diagrama de flujo de Mermaid en el compositor de diagramas. Insertar como Mermaid lo añade como un bloque de código delimitado:

```mermaid
flowchart LR
  A[Sample] --> B[Measure]
```

En el modo Ambos, el lado con formato dibuja el bloque como un diagrama. Un PDF necesita una imagen, así que el compositor también guarda un PNG generado en figures/mermaid-<hash>.png, y la compilación coloca esa imagen en lugar del bloque. Por eso el diagrama también aparece en el PDF compilado. Si después editas el bloque a mano, el PDF muestra el código hasta que vuelvas a insertar o guardar el diagrama desde el compositor. Consulta Mermaid en documentos de Markdown.

Citas y bibliografía

Importa o crea references.bib, añade bibliography: references.bib a los metadatos YAML y cita una clave existente con [@citation-key]. Pandoc usa la bibliografía para generar las citas con formato y una lista de referencias.

Busca y gestiona referencias →

Importar y exportar

Para mantener en Markdown un borrador existente, crea un Blank Markdown document, pega el borrador en main.md e importa sus imágenes y su bibliografía. La importación independiente Documento de Markdown de la biblioteca convierte por ahora un borrador a LaTeX. Rutas de importación explica las dos vías.

Compila para obtener un PDF, o usa Exportar para crear Word, HTML, Typst, LaTeX o texto sin formato. Usa un ZIP del código para compartir el Markdown original y sus recursos. Exporta tu trabajo trata la secuencia y las comprobaciones que conviene hacer en el archivo convertido.