# Escribe en Markdown Redacta con el Markdown de siempre y obtén un PDF o un documento editable para tus colaboradores. 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. ```markdown title="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](/examples/writing-example.md) ## 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](/docs/figures-diagrams/) 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](#mermaid-diagrams). ### 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](/docs/document-insights/). ### 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](/docs/document-settings/#markdown). ### 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: ```markdown $$ \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: ````markdown ```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-.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](/docs/figures-diagrams/#mermaid-in-markdown-documents). ## 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 →](/docs/citations/) ## 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](/docs/import-project/) 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](/docs/export/) trata la secuencia y las comprobaciones que conviene hacer en el archivo convertido.