Publicar artículos en GitHub

Conecta GitHub una vez y podrás publicar cualquier artículo de Clevera en un repositorio como un archivo Markdown, listo para un sitio de documentación, una carpeta docs/ estilo wiki o una colección de README. Este artículo cubre cómo conectar, elegir el repositorio y la carpeta, cómo se ve el archivo y cómo funcionan las actualizaciones.

Antes de empezar#

• Plan: la publicación en GitHub es parte de los planes Pro y Custom. En los planes Free y Starter, la pestaña Publicar muestra "La publicación en tus herramientas está incluida en Pro". Consulta Elegir un plan.
• Rol en Clevera: solo el propietario del espacio de trabajo o un Administrador puede conectar o desconectar GitHub. Una vez conectado, cualquier persona que pueda editar un artículo puede publicarlo.
• Acceso en GitHub: la persona que realiza la conexión necesita acceso de escritura a los repositorios en los que deseas publicar y el derecho a instalar una aplicación de GitHub en esa cuenta personal u organización (o que un propietario de la organización la apruebe).
• Un artículo: publicas el artículo que pertenece a un video o grabación. Generalo primero; consulta Convertir una grabación en un artículo.

La publicación no utiliza créditos.

Conectar GitHub#

1. Abrir Integraciones#

   En la barra lateral, abre el menú del espacio de trabajo y elige Integraciones. Busca GitHub en Integraciones disponibles (o en la pestaña Desarrollo) y haz clic en Conectar. El botón aparece cuando señalas la tarjeta.

   

2. Autorizar a Clevera en GitHub#

   GitHub te pedirá que autorices la aplicación Clevera AI. Solicita acceso de lectura a las membresías de tu organización, para que Clevera pueda listar las cuentas a las que perteneces. Haz clic en Autorizar.

3. Instalar la aplicación en tus repositorios#

   GitHub abrirá entonces la página de instalación de la aplicación Clevera AI. Elige tu cuenta personal o una organización, luego selecciona Todos los repositorios o Solo seleccionar repositorios. La aplicación solicita:

   Permiso de GitHub	Por qué
   Contenido: lectura y escritura	Para crear y actualizar el archivo Markdown y sus imágenes
   Metadatos: solo lectura	Requerido por GitHub para cada aplicación; permite a Clevera listar repositorios

   Haz clic en Instalar. Repite el proceso para cada organización en la que desees publicar.

4. Comprobar la conexión#

   De vuelta en Integraciones, GitHub se mueve a la lista Conectado con el nombre de tu cuenta de GitHub u organización y una insignia de Conectado. Antes de publicar nada, dirá "Nada publicado aún".

   

Añadir o eliminar repositorios más tarde#

Clevera solo ve los repositorios en los que está instalada la aplicación. Para cambiar eso, abre Integraciones, haz clic en GitHub y, en Acceso, haz clic en Acceso al repositorio. En GitHub, abre la cuenta, haz clic en Configurar y cambia la lista de repositorios. Los nuevos repositorios aparecerán la próxima vez que abras la pestaña Publicar.

Publicar un artículo#

1. Abrir la pestaña Publicar#

   En el editor, haz clic en Compartir y abre la pestaña Publicar. En Publicar el artículo, haz clic en el mosaico de GitHub bajo Listo para publicar.

   El artículo se publica en el idioma que tienes abierto en el editor. Cambia el idioma en la barra superior primero para publicar una traducción.

2. Elegir la cuenta, el repositorio y la carpeta#

   En Dónde se guarda, elige:

   Campo	Qué elegir	Notas
   Cuenta	Tu cuenta personal o una organización	Solo se muestra cuando tus repositorios pertenecen a más de una cuenta
   Repositorio	El repositorio para el archivo	Primero los actualizados más recientemente. El primero está seleccionado para ti
   Carpeta	Una ruta como docs o articles/guides	"El archivo Markdown se crea aquí. Déjalo vacío para la raíz del repositorio." Comienza como docs. Las carpetas que aún no existen se crean

   Clevera recuerda lo que elegiste para la próxima vez.

   

3. Publicar#

   Haz clic en Publicar en GitHub. Verás "Buscando una copia existente en GitHub", luego Escribiendo la página. Cuando termine, verás "Publicado en GitHub". Haz clic en Abrir en GitHub para ver el archivo.

   Puedes cerrar la ventana Compartir mientras se ejecuta; una notificación te avisará cuando termine.

Dónde va el archivo#

• Rama: la rama predeterminada del repositorio (normalmente main). Clevera hace commit directamente en ella; no abre una solicitud de extracción (pull request) y no puedes elegir otra rama.
• Nombre del archivo: el título en minúsculas, con espacios convertidos en guiones, terminando en .md. "Create your first invoice" se convierte en create-your-first-invoice.md. Los títulos en otros alfabetos o con acentos se escriben primero en letras latinas ("Créer une facture" se convierte en creer-une-facture.md). Un título sin nada que escribir, como uno hecho solo de emojis, obtiene un código fijo corto en su lugar (article- más 8 caracteres). Los nombres se cortan a 80 caracteres.
• Imágenes: las capturas de pantalla del artículo van a assets/<file name>/ dentro de la misma carpeta, en el mismo commit.
• Mensaje de commit: Add article: <title>, o Update article: <title> cuando actualizas un archivo existente.
• Autor del commit: la cuenta de GitHub que conectó la integración.

Cómo se ve el archivo#

Clevera escribe Markdown estilo GitHub con un bloque de front matter corto en la parte superior:

---
title: "Create your first invoice"
created_at: "2026-10-12T09:30:00+00:00"
updated_at: "2026-10-12T10:05:00+00:00"
source: "Clevera"
---

El video del que proviene el artículo no se añade al archivo. Un video de Clevera colocado dentro del artículo se convierte en un enlace a su reproductor, solo cuando el enlace para compartir de ese video está activado. Consulta Mostrar un video en un artículo.

Imágenes#

Las capturas de pantalla se confirman en tu repositorio junto al archivo, y el Markdown enlaza a ellas mediante una ruta relativa (assets/<file name>/…). Siguen funcionando sin Clevera, y en un repositorio privado permanecen tan privadas como el resto del mismo.

Un archivo de video que subiste al artículo no se confirma. Sigue siendo un enlace a Clevera que caduca después de un tiempo; publica de nuevo para renovarlo.

Usarlo con un sitio de documentación#

La mayoría de los generadores de sitios estáticos que construyen desde un repositorio (como Docusaurus, MkDocs, Jekyll o Hugo) leen title desde el front matter e ignoran los campos que no conocen. Una configuración común:

1. Apunta la Carpeta a la carpeta que lee tu sitio de documentación, por ejemplo docs o content/guides.
2. Publica cada artículo allí; la compilación normal de tu sitio recoge el nuevo commit.
3. Comprueba si tu generador renderiza alertas de GitHub, matemáticas y <details>; algunos muestran alertas como citas simples.

Actualizar un artículo que ya publicaste#

La publicación solo va en una dirección. Las ediciones que haces en Clevera permanecen en Clevera hasta que publicas de nuevo, y los cambios realizados en el archivo en GitHub nunca vuelven a Clevera.

Cuando publicas en el mismo repositorio y carpeta, Clevera encuentra el archivo con el mismo nombre y muestra "Este artículo ya está en GitHub". Haz clic en Verlo para abrir el archivo existente, luego elige:

Si el título cambia en Clevera, el nombre del archivo también cambia, por lo que al publicar se crea un archivo nuevo junto al anterior. Elimina o cambia el nombre del archivo antiguo en GitHub tú mismo.

Nada en Clevera elimina archivos de tu repositorio.

Desconectar GitHub#

1. Abre Integraciones, haz clic en el menú ⋯ en la fila de GitHub y elige Desconectar (o haz clic en GitHub y luego en Desconectar).
2. Confirma. "Ya no podrás publicar desde el editor. El contenido que ya hayas publicado permanecerá en GitHub."

Al desconectar, se elimina el token de acceso de Clevera. Para eliminar también el acceso de Clevera en GitHub, desinstala la aplicación Clevera AI (Ajustes de GitHub → Applications → Installed GitHub Apps → Configure → Uninstall) y revoca la autorización en Authorized GitHub Apps.

Solución de problemas#

Relacionado#