De Markdown a un PDF digno de compartir

1. Empieza por tu Markdown

Pega tu texto en el editor o abre un archivo .md, .markdown o .txt. Empieza con un título de documento descriptivo y luego usa secciones para organizar el resto. Tus cambios actualizan la vista previa a medida que escribes; no hay un paso separado de guardar o actualizar para ver los cambios. En una pantalla más pequeña, usa las pestañas de editor y vista previa para moverte entre escribir y revisar.

Guarda una copia del Markdown original. Si pruebas una plantilla, revisa su contenido antes de exportar para que el texto de ejemplo no termine en tu documento final.

2. Usa los títulos y el énfasis con criterio

Escribe un único título principal con un solo # seguido de un espacio. Usa ## para las secciones principales y ### para las subsecciones. Envuelve una palabra en dos asteriscos para negrita o en uno para cursiva; tres aplican ambas cosas. Mantén los marcadores emparejados a cada lado. Añadir asteriscos adicionales de forma repetida hace que el origen sea más difícil de leer y puede cambiar cómo lo interpreta el analizador.

# Resumen del proyecto

## El objetivo

Deja claro el **punto importante**.
Usa *el énfasis* con moderación, o ***combina ambos***.

- Primera acción
- Segunda acción

Deja una línea en blanco entre párrafos y alrededor de las listas. Un salto de línea en el origen no siempre es un nuevo párrafo en el PDF. Unos títulos coherentes también hacen más útil un índice generado automáticamente.

3. Mantén las tablas y el código fáciles de leer

Las tablas son útiles para comparaciones breves. Incluye una fila separadora debajo de los nombres de columna y mantén cada celda concisa. Una tabla ancha que se ve cómoda en un monitor puede resultar apretada en papel. Divide una comparación grande en tablas más pequeñas o traslada las explicaciones largas al párrafo siguiente.

| Tarea | Estado |
| --- | --- |
| Borrador | Completado |
| Revisión | En curso |

```javascript
const total = 3 * 4;
console.log(total);
```

Usa bloques de código delimitados para ejemplos de varias líneas y comillas invertidas para un comando corto en línea. Acorta las líneas de código muy largas antes de exportar; la página impresa no puede expandirse horizontalmente como tu editor.

4. Añade imágenes que aporten al documento

Una imagen usa un signo de exclamación, un texto descriptivo entre corchetes y su origen entre paréntesis. Sustituye la dirección de ejemplo de abajo por la de tu propia imagen. La herramienta Imágenes también te permite elegir un PNG, JPEG, GIF o WebP local y lo incrusta en el Markdown. Escribe un texto alternativo útil en lugar de dejar un nombre de archivo sin explicar.

![Cronograma del proyecto con tres hitos](https://example.com/timeline.png)

Comprueba que todas las imágenes aparecen antes de descargar. Una imagen remota puede requerir permiso o dejar de estar disponible; una ruta de archivo local de tu ordenador no está automáticamente disponible para el servidor de exportación. Prefiere imágenes de tamaño adecuado en lugar de originales muy pesados.

Diagramas, matemáticas y saltos de página

Un bloque delimitado con el lenguaje mermaid se convierte en un diagrama. El TeX entre signos de dólar simples es una fórmula en línea, y entre signos de dólar dobles en sus propias líneas es una fórmula centrada. Una línea que solo contenga \newpage fuerza un salto de página. Un bloque de front matter al principio del todo define el título, subtítulo, autor, fecha y palabras clave que usan la portada y las propiedades del PDF.

---
title: Payment service spec
author: Sam
---

```mermaid
flowchart LR
  A[Order] --> B[Charge] --> C[Receipt]
```

The wait after attempt $n$ is $w_n = 2^n \cdot 250$ ms.

\newpage

Los diagramas se dibujan en tu navegador y se envían junto con la solicitud de PDF, así que nada sobre el diagrama se almacena en el servidor.

5. Ajusta la maquetación antes de la revisión final

Elige A4, A5 o Letter, y luego selecciona el estilo de documento Limpio, Editorial o Técnico. Estos ajustes cambian el documento exportado. Los márgenes cómodos, compactos y amplios son puntos de partida rápidos; los márgenes personalizados te permiten ajustar cada borde en milímetros. Deja espacio para encabezados y pies de página recurrentes si los usas.

Activa un índice para un documento más largo; usa los tres primeros niveles de título. Revisa la numeración de páginas y cualquier texto o logotipo de marca. Cambiar el sitio web entre modo claro y oscuro es una preferencia de lectura, no una solicitud para imprimir el documento sobre un fondo oscuro.

6. Exporta, inspecciona y descarga

Genera el PDF cuando la vista previa se vea bien. La vista previa en vivo es útil mientras editas; el PDF generado es la comprobación final de los saltos de página, la colocación de las imágenes y el contenido recurrente. Ábrelo e inspecciona la primera página, una página con una tabla y la última página antes de compartirlo.

El texto normal del documento sigue siendo seleccionable en el PDF. MDPress obtiene el nombre del archivo descargado a partir de tu primer título principal, recurriendo a otro título o a la primera línea no vacía. Por ejemplo, «Resumen del proyecto» se convierte en «resumen-del-proyecto.pdf». Elige un título claro para que el archivo tenga sentido fuera de tu carpeta de descargas.

Problemas de formato habituales que conviene revisar

Si el formato se ve mal, busca un bloque de código sin cerrar, marcadores de énfasis sin pareja o una línea en blanco que falte. Si el contenido se ve apretado, acorta las celdas de la tabla o ajusta el formato de página y los márgenes. El HTML sin procesar se trata como texto, y el bloque YAML inicial se elimina; usa los controles del documento para los ajustes de impresión disponibles en lugar de esperar que el HTML incrustado o el bloque inicial configuren la exportación.

Adónde van tu borrador y tu exportación

El texto del borrador, los ajustes y los preajustes guardados usan el almacenamiento local de este navegador. No son una copia de seguridad en la nube y pueden desaparecer si borras los datos del navegador. Exportar envía tu Markdown y los ajustes del documento al servidor de MDPress para generar el PDF. Descarga una copia en Markdown cuando quieras un archivo de origen reutilizable, especialmente antes de cambiar de dispositivo.