Editor de documentos — Guía del usuario

Para qué sirve el módulo «Docs»

El módulo es un editor rich-text completo dentro de YoBench para wikis internos, notas personales y documentación de proyecto. Bajo el capó — TipTap sobre ProseMirror: menú de comandos /, set extenso de bloques, diagramas Mermaid y Draw.io, fórmulas KaTeX, wiki-enlaces entre páginas, historial de versiones y asistente IA.

Lo que obtienes:

Jerarquía de páginas — documentos anidados con árbol en la barra lateral y migas de pan.
Editor rich — encabezados, listas de tareas, tablas, citas, bloques de código con resaltado de sintaxis (28 lenguajes), callouts, toggles, tabla de contenido, find & replace, selector de emojis.
Diagramas y fórmulas — Mermaid, Draw.io (interactivo), KaTeX.
Medios — imágenes redimensionables, embeds de YouTube/Vimeo, adjuntos.
Wiki-enlaces — [[Nombre de página]] con autocompletado; backlinks rastreados automáticamente.
Historial de versiones — hasta 50 snapshots por página con restauración.
Asistente IA — Summarize, Continue Writing, Translate (8 idiomas), Improve Text.
Exportación/importación — Markdown, HTML, ZIP; importar .md crea una nueva página.
Almacenamiento local — todas las páginas y versiones en la base cifrada de YoBench.
Favoritos y papelera paginados — las listas largas de páginas favoritas o eliminadas se cargan por páginas y la barra lateral sigue ágil.

Parámetros de la página

Al crear o editar:

Título — nombre visible.
Icono — emoji del selector.
Imagen de portada — URL (opcional).
Padre — para anidar.
Banderas — favorita, eliminada (papelera), plantilla.

Etiquetas y categorías no están implementadas — la estructura se hace por jerarquía y favoritos.

Funciones del editor

Formato

Negrita, cursiva, subrayado, tachado, código en línea.
Color de texto, resaltado, subíndice y superíndice.
Alineación (izquierda / centro / derecha).

Bloques estructurales

Encabezados H1, H2, H3.
Listas con viñetas y numeradas.
Listas de tareas con casillas.
Citas, bloques de código (28 lenguajes, lowlight).
Tablas con edición de celdas.
Divisores horizontales.
Bloques callout: Info / Warning / Success / Error.
Bloques toggle (plegables).
Tabla de contenido dinámica (TOC).

Bloques avanzados

Wiki-enlaces — [[Nombre de página]] con autocompletado de páginas existentes.
Mermaid — diagramas en código.
Draw.io — editor vectorial interactivo.
KaTeX — matemáticas en línea y en bloque.
Vídeo — embeds de YouTube/Vimeo.
Imágenes — subida drag-and-drop con redimensionado.
Adjuntos — archivos arbitrarios adjuntos a una página.

Comandos slash

Escribe / en el editor — se abre un menú de inserciones rápidas: /heading1, /heading2, /heading3, /bulletList, /taskList, /table, /image, /codeBlock, /math, /mermaid, /drawio, /video, /quote, /toggle, /toc, /divider y más.

Find & Replace, selector de emojis

Búsqueda y reemplazo estándar más selector de emojis desde la barra de herramientas.

Historial de versiones

Un snapshot (docs_page_versions) se crea automáticamente al cambiar a otra página.
Hasta 50 versiones por página; las más antiguas se eliminan.
En el UI Historial de versiones se ven los snapshots con marca de tiempo; Restaurar convierte la versión elegida en la actual y guarda el contenido previo como nueva versión.

Asistente IA

La barra de herramientas tiene un botón de auto-mejora. Acciones disponibles:

Summarize — resumen breve del texto seleccionado o de la página.
Continue Writing — continúa el texto en el mismo estilo.
Translate — traducción a 8 idiomas (inglés, ruso, alemán, español, francés, portugués, chino, japonés).
Improve Text — mejora gramática y claridad.

Los resultados se pueden insertar en la posición del cursor o reemplazar la selección. El proveedor IA viene de los ajustes globales del módulo.

Exportación e importación

Markdown (.md) — exporta la página actual.
HTML (.html) — exporta con estilos inline.
ZIP (Markdown) — todas las páginas como conjunto de .md.
ZIP (HTML) — todas las páginas como conjunto de .html.
Importar .md — crea una nueva página desde un archivo.
Enviar a contexto — el contenido de la página se puede empujar al Context Manager & RAG para búsqueda IA posterior.

Ajustes globales

En Ajustes → Docs:

Proveedor IA para Docs (docsAiProviderId) — qué proveedor del registro AI Chat impulsa Summarize / Continue / Translate / Improve.

Flujo de uso

1. Crea tu primera página

Abre el módulo Docs en el menú lateral izquierdo.
En la barra lateral pulsa + Nueva página.
Introduce un título y opcionalmente elige un icono.
Abre la página.

2. Escribe contenido

Escribe el texto; / abre el menú slash.
Arrastra archivos al editor para adjuntos e imágenes.
Usa [[]] para un wiki-enlace a otra página.

3. Construye la estructura

Arrastra páginas en la barra lateral para cambiar la jerarquía.
Marca las páginas usadas con frecuencia como Favoritas.

4. Usa el asistente IA

Selecciona texto → botón IA en la barra → elige una acción. El resultado se inserta o reemplaza la selección.

5. Vuelve a una versión

Abre el panel Historial de versiones → elige un snapshot → Restaurar. El contenido actual se conserva como otra versión.

6. Exporta

Menú de la página → Exportar → elige un formato. Para todo el árbol — Exportar ZIP.

Siguientes pasos

Conecta los proveedores de IA para que funcione el asistente IA.
Empuja tu documentación a Contextos y RAG para que AI Chat responda desde ella.
Para mapas mentales y pizarra, usa Board.

Ayuda y comentarios

¿Quieres etiquetas, edición colaborativa o más formatos de exportación? Escríbenos a través del formulario de contacto.