docs

Resumen de sintaxis de Markdown

2026-05-06
FeelFish Team

Referencia rápida de sintaxis Markdown

Una guía de referencia rápida de Markdown para escritores de ficción. Los modelos de lenguaje extensos reciben y devuelven texto, y Markdown es un formato de texto plano minimalista con especificaciones de formato, ampliamente adoptado hoy en día por diversos LLMs. Puedes considerar Markdown como un formato nativo de la IA. Familiarizarse con la sintaxis de Markdown es de gran ayuda para las habilidades de escritura, el aprendizaje de la escritura asistida por IA y más.


¿Por qué Markdown?

Markdown es un lenguaje de marcado ligero que te permite expresar intenciones de formato dentro de texto plano. Para los escritores de ficción, el beneficio es directo: concéntrate en escribir, no en maquetar. No necesitas buscar botones en los menús: solo unos pocos símbolos simples para marcar títulos, énfasis y cambios de sección. Una vez que termines de escribir, puedes exportar a Word, PDF, libros electrónicos y muchos otros formatos.


1. Títulos

Los títulos comienzan con el símbolo #. Cuantas más almohadillas, más profundo es el nivel del título. En la escritura de ficción, los más utilizados son los títulos de capítulo y los encabezados de sección.

# Capítulo 1: Antes del amanecer
## Sección 1: Partida
### Escena uno: Noche lluviosa

Efecto:

Capítulo 1: Antes del amanecer

Sección 1: Partida

Escena uno: Noche lluviosa

Consejo de escritura: Usa # para títulos de capítulo, ## para encabezados de sección y ### para pequeñas marcas como transiciones de escena o saltos temporales. Generalmente no se necesitan niveles más profundos.


2. Párrafos y saltos de línea

En Markdown, dejar una línea en blanco entre dos bloques de texto crea un párrafo. Es el mismo efecto que pulsar Intro dos veces en Word.

Empujó la puerta y entró en la habitación abandonada durante mucho tiempo. El aire estaba cargado del olor rancio a madera vieja.

La luz de la luna se filtraba a través de la ventana rota, pintando un pálido y fantasmal reguero de luz sobre las tablas del suelo.

Si solo quieres un salto de línea dentro de un párrafo (sin crear espacio entre párrafos), usa un solo salto de línea en lugar de una línea en blanco (FeelFish lo soporta: un solo salto de línea producirá una nueva línea sin espacio adicional).

Empujó la puerta y entró en la habitación abandonada durante mucho tiempo. El aire estaba cargado del olor rancio a madera vieja.
La luz de la luna se filtraba a través de la ventana rota, pintando un pálido y fantasmal reguero de luz sobre las tablas del suelo.

3. Énfasis y realce

Esta es una de las herramientas de formato más usadas por los escritores de ficción: ideal para marcar monólogos interiores de personajes, términos especiales o tonos que necesitan énfasis.

SintaxisEfectoUso común
*texto en cursiva*texto en cursivaMonólogo interior, cartas, recuerdos
**texto en negrita**texto en negritaÉnfasis fuerte, palabras clave
***negrita cursiva***negrita cursivaIntensidad extrema o gritos
~~tachado~~tachadoTexto tachado por un personaje, huellas de revisión

Ejemplo de escritura:

Miró fijamente la carta, un solo pensamiento resonaba en su mente: *Esto no puede ser real.*

—Debes **marcharte** antes del amanecer. —La voz del anciano no admitía duda.

4. Líneas divisorias (cambios de escena)

En la ficción a menudo se necesita marcar cambios de escena, saltos temporales o cambios de perspectiva. En Markdown, usa tres o más guiones, asteriscos o guiones bajos para crear una línea divisoria:

Cerró la puerta y nunca miró atrás.

---

Tres años después. Una tarde soleada, la cafetería de la esquina bullía de voces.

Las tres opciones funcionan: ---, ***, ___. Producen el mismo efecto. Se recomienda usar siempre --- por consistencia.


5. Citas en bloque

Las citas en bloque comienzan con >. Son perfectas para insertar cartas, entradas de diario, reportajes de prensa, inscripciones y otros textos incrustados en la ficción.

Abrió el diario amarillento. En la primera página decía:

> 14 de marzo de 1987, soleado.
>
> Tomé una decisión hoy. Si todo sale bien, mañana a esta hora
> ya no estaré en ningún lugar de esta ciudad.

Sus dedos temblaron ligeramente.

Para citas anidadas, usa >>:

> Escribió en su carta:
>
>> Si estás leyendo esta carta, significa que ya me he ido.
>> No me busques.

6. Listas

Las listas no son comunes en la prosa de ficción, pero son muy prácticas para esquemas, notas de construcción de mundo y perfiles de personajes.

Listas no ordenadas (comienzan con -, * o +):

- Personajes principales
  - Lin Yuanzhou: Protagonista masculino, exsoldado, taciturno
  - Su Wan: Protagonista femenina, periodista, obstinada
- Personajes secundarios
  - Viejo Chen: Dueño de la taberna

Listas ordenadas (comienzan con un número seguido de .):

1. Primer acto: Vida cotidiana y presagios
2. Segundo acto: Estalla el conflicto
3. Tercer acto: Clímax y punto de inflexión
4. Cuarto acto: Desenlace

7. Código y fuente monoespaciada

Ocasionalmente, puedes necesitar representar texto en pantalla, mensajes SMS, salida de terminal u otros contenidos de "lenguaje no natural" en la ficción. Usa acentos graves para ello:

Código en línea — se envuelve con un solo acento grave:

Una línea de texto parpadeó en la pantalla: `ACCESO DENEGADO`.

Bloques de código — envuelve todo el pasaje con tres acentos graves:

La pantalla del móvil se iluminó con un mensaje:

```
Remitente: Número desconocido
¿Estás seguro de que quieres abrir esa puerta?
```

8. Enlaces e imágenes

Los enlaces de referencia y las imágenes pueden ser útiles para notas de escritura.

Enlaces:

Para investigación histórica sobre este evento, consulta [Wikipedia](https://es.wikipedia.org).

Imágenes:

![Boceto de escena](imagenes/escena01.png)

La sintaxis de imagen simplemente añade un ! delante de un enlace. El texto entre corchetes sirve como descripción alternativa cuando la imagen no se puede mostrar.


9. Notas al pie

Algunos editores Markdown admiten notas al pie, útiles para añadir notas del traductor, antecedentes históricos y anotaciones similares a la ficción:

Aquel año, toda la ciudad hablaba del "Proyecto Galaxia"[^1].

[^1]: "Proyecto Galaxia" es una iniciativa ficticia de migración espacial, inspirada en la carrera lunar de los años sesenta.

10. Técnicas especiales de formato

Centrar texto

Markdown estándar no admite centrado, pero muchos editores y herramientas de exportación admiten etiquetas HTML:

<div align="center">

**Volumen Dos**

*La tormenta que se avecina*

</div>

Formatear diálogos

Para diálogos en ficción en español, usa simplemente guiones largos y pon cada intervención en su propio párrafo:

—¿Adónde vas? —preguntó ella desde la puerta.

—Solo a dar un paseo. —Él no miró atrás.

—¿Ahora? Está lloviendo fuera.

Se detuvo un momento—: Perfecto.

Cada línea de diálogo forma su propio párrafo: este es el enfoque más limpio.

Notas del autor y memos de escritura

Puedes usar comentarios HTML para dejar notas para ti mismo que no aparecerán en la salida exportada:

Entró en la cafetería.
<!-- TODO: Añadir aquí descripción del entorno; el ambiente de la cafetería debe resonar con el Capítulo 3 -->
El dueño levantó la vista y la reconoció.

Chuleta de referencia rápida

FunciónSintaxisEjemplo
Título de capítulo# Título# Capítulo 1: Amanecer
Encabezado de sección## Título## Sección 3: Reencuentro
Cursiva*texto*monólogo interior
Negrita**texto**énfasis
Línea divisoria---Cambio de escena
Cita en bloque> textoCartas, diarios
Lista no ordenada- elementoLista de personajes
Lista ordenada1. elementoEsquema
Código en línea`texto`Texto en pantalla
Enlace[texto](url)Material de referencia
Imagen![descripción](ruta)Boceto de escena
Comentario<!-- contenido -->Memo de escritura

Un último consejo: La esencia de Markdown es "lo justo para arreglárselas". Al escribir ficción, no te pierdas en florituras tipográficas. Deja que los símbolos sirvan al contenido, no al revés. Abre tu editor y empieza a escribir: eso es lo que realmente importa.