Escribe artículos y organiza colecciones

Shayan TaslimActualizado

Tu Centro de ayuda organiza los artículos dentro de colecciones y ofrece a tu equipo un editor de texto enriquecido con enlaces internos, historial de revisiones y controles de visibilidad.

Organizar colecciones

Abre Centro de ayuda → Artículos en la barra lateral del panel para gestionar el árbol de navegación.

  • Crea una colección. Haz clic en Nueva colección en la barra superior, introduce un Nombre (hasta 255 caracteres; UserJot sugiere un icono automáticamente mientras escribes, hasta que elijas uno manualmente), selecciona un Icono y haz clic en Crear. Las colecciones nuevas aparecen al final del nivel superior.

  • Edita una colección. Haz clic con el botón derecho en una colección y selecciona Editar… para cambiar su icono, nombre o Descripción (hasta 500 caracteres).

  • Anida y reordena. Arrastra y suelta colecciones y artículos en el árbol para reordenarlos o anidarlos, o haz clic con el botón derecho y elige Mover a. Las colecciones se pueden anidar hasta tres niveles.

  • Artículos de nivel superior y sin ubicar. Los artículos ubicados en Nivel superior aparecen fuera de cualquier colección y pueden tener un icono personalizado (haz clic con el botón derecho → Cambiar icono…). Al hacer clic en Nuevo artículo en la barra superior, se crea un borrador sin ubicar en Sin colección. Los artículos sin ubicar no aparecen en los listados ni se pueden buscar hasta que los ubiques en el Nivel superior o dentro de una colección.

  • Elimina una colección. Haz clic con el botón derecho en una colección y selecciona Eliminar…. Las colecciones se eliminan de forma permanente, sin pasar por la papelera. Si la colección contiene artículos, elige Mover sus artículos a otra colección, al Nivel superior o a Sin colección (si los mueves a otra colección, las URL antiguas de la colección eliminada redirigirán allí).

Escribir con el editor

Cada artículo tiene un Título obligatorio (hasta 255 caracteres), una Descripción opcional (hasta 500 caracteres; se usa en las tarjetas y como metadescripción) y un editor del cuerpo.

Pulsa / en una línea nueva para insertar bloques:

  • Texto, Encabezado (H2) y Subencabezado (H3). Los encabezados generan automáticamente anclas de sección estables.

  • Lista con viñetas, Lista numerada, Cita, Bloque de código (con selector de lenguaje) y Separador.

  • Imagen (sube archivos desde tu ordenador; haz clic en una imagen para añadir Texto alternativo o un Pie de foto, de hasta 500 caracteres cada uno).

  • Tabla (se crea como una tabla de 3 × 3 con una fila de encabezado y controles flotantes para filas y columnas).

  • Bloques destacados de Nota, Consejo y Advertencia, además de bloques Acordeón desplegables (títulos de 1 a 200 caracteres). En el editor del panel de control, los bloques destacados y los acordeones no pueden anidarse entre sí (mediante la API o la importación de HTML, puede haber un bloque destacado dentro de un acordeón, pero no se permiten bloques destacados dentro de otros bloques destacados, acordeones dentro de bloques destacados ni acordeones dentro de otros acordeones).

  • Inserciones de Video de YouTube, Loom o Vimeo (o pega un enlace sin formato de esos proveedores en una línea aparte).

Selecciona texto para aplicar Negrita, Cursiva, Tachado, Código, Tecla (estilo de atajo de teclado) o enlaces. Código y Tecla no se pueden combinar con otras marcas de formato en línea, y el texto con formato de Tecla no puede contener < ni >. Los documentos admiten hasta 1 MB de JSON, 512 KB de Markdown, 5.000 nodos y 32 niveles de anidación de bloques.

Los borradores se guardan automáticamente mientras escribes. Pulsa ⌘S / Ctrl+S para guardar manualmente; pulsa ⌘⇧\ / Ctrl+Shift+\ para mostrar u ocultar el panel de la lista de artículos; activa o desactiva Vista previa en la esquina inferior derecha para comprobar la vista del lector, o haz clic en el control Sonido de escritura de la esquina inferior izquierda para elegir sonidos mecánicos opcionales de teclas (Alpaca, Cream, Mint, Mochi, Frost o Desactivado) y ajustar el volumen con un control deslizante.

Variante de Markdown del Centro de ayuda

La API REST, el servidor MCP, Copiar página y los endpoints .md usan Markdown con sabor a GitHub, ampliado con:

  • Bloques destacados <Note>, <Tip> y <Warning>

  • Secciones desplegables <Accordion title="...">

  • {#custom-id} al final de un encabezado para fijar un ancla estable

  • <kbd>...</kbd> para teclas de teclado en línea

  • Enlaces internos escritos como /articles/<slug> o /collections/<slug> (con #heading opcional)

Haz clic en el botón de enlace de la barra de herramientas de selección para abrir Añadir enlace. Busca artículos, colecciones y encabezados de artículos publicados en tu Centro de ayuda (la búsqueda de encabezados requiere al menos 2 caracteres y muestra hasta 8 coincidencias), o pega una URL externa https://. Si pegas la URL de uno de tus propios artículos de ayuda, se convertirá en una referencia interna que seguirá funcionando aunque cambie el slug del artículo de destino.

Si más adelante se retira de publicación, se envía a la papelera o se elimina un destino enlazado, el editor resalta ese enlace en línea para que puedas corregirlo. La lista Enlazado desde en el panel Artículo de la derecha muestra hasta ocho artículos publicados que enlazan al artículo actual.

Abre el panel Artículo de la derecha para configurar cómo encuentran los lectores un artículo:

Configuración

Qué hace

Visibilidad

Elige Público (aparece en los listados, se puede buscar y se incluye en llms.txt y Juno), No listado (solo se puede acceder mediante un enlace directo; está oculto en la navegación, las búsquedas y Juno) o Equipo (solo para administradores internos y propietarios con sesión iniciada).

Colección

Ubica el artículo en el Nivel superior, dentro de una colección o déjalo en Sin colección.

Enlace

Haz clic en /help/articles/<slug> para abrir Cambiar enlace (letras minúsculas, números y guiones, hasta 60 caracteres). Antes de la primera publicación, el slug sigue el título hasta que lo editas manualmente. Después de publicar, si cambias el slug, se crea automáticamente una redirección desde la URL anterior.

Mostrar en motores de búsqueda

Permite o bloquea la indexación de este artículo por los motores de búsqueda. Para que se indexe, el artículo también debe ser público y estar ubicado en una colección, y el Centro de ayuda debe estar Activo.

Palabras clave

Añade palabras clave ocultas para las búsquedas en el idioma actual (hasta 50 palabras clave, de 64 caracteres cada una). Pulsa Intro o una coma para añadir cada término.

También puedes asignar un Autor (o seleccionar Sin autor) en la tarjeta de estado, en la parte superior del panel derecho.

Publicar, historial y papelera

  • Publica. Haz clic en Publicar (o Publicar cambios; atajo: ⌘↵). Antes de publicar, el menú emergente advierte si falta texto alternativo en alguna imagen o si hay enlaces internos rotos. Al actualizar un artículo publicado, desactiva Mostrar como actualizado si solo estás corrigiendo errores tipográficos menores, para que la fecha de actualización pública no cambie.

  • Retira de publicación. Abre Más acciones (⋮) → Retirar de publicación para dejar fuera de línea el idioma actual y conservar su borrador y su historial de revisiones.

  • Historial de revisiones. Selecciona cualquier entrada de Historial en el panel derecho para consultarla en modo de solo lectura (pulsa Esc para salir de la vista previa). Después, haz clic en Restaurar esta versión para copiarla en tu borrador (seguirá sin publicarse hasta que hagas clic en Publicar cambios).

  • Compara traducciones. Al editar un artículo traducido, activa Comparar en la barra superior (en pantallas anchas) para ver el original publicado en paralelo, con los bloques modificados, añadidos y eliminados resaltados.

  • Papelera y restauración. Abre Más acciones (⋮) → Mover a la papelera para eliminar un artículo de inmediato. Los artículos en la papelera se pueden restaurar durante 30 días (se reservan sus slugs y redirecciones) antes de su eliminación permanente. Al abrir un artículo en la papelera, aparece el botón Restaurar de la papelera.

Siguientes pasos

¿Respondió esto a tu pregunta?