Publicar artículos en Bitbucket

Conecta Bitbucket una vez y podrás publicar cualquier artículo de Clevera en un repositorio de Bitbucket como un archivo Markdown, listo para un sitio de documentación o una docs/ carpeta junto a tu código. 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: publicar en Bitbucket 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 Bitbucket. Una vez conectado, cualquier persona que pueda editar un artículo puede publicarlo.
• Solo Bitbucket Cloud: Clevera se conecta a bitbucket.org. Bitbucket Data Center y Server no son compatibles.
• Acceso en Bitbucket: la cuenta que realiza la conexión debe tener capacidad para contribuir a los repositorios en los que deseas publicar, con acceso de escritura a la rama principal.
• 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 consume créditos.

Conectar Bitbucket#

1. Abrir Integraciones#

   En la barra lateral, abre el menú del espacio de trabajo y elige Integraciones. Busca Bitbucket en Integraciones disponibles (o en la pestaña Desarrollo) y haz clic en Conectar.

2. Conceder acceso en Bitbucket#

   Inicia sesión en Bitbucket si aún no lo has hecho. Bitbucket te pedirá que concedas acceso a Clevera:

   Permiso de Bitbucket	Por qué
   Cuenta: lectura	Para mostrar tu nombre de Bitbucket en Clevera
   Repositorios: lectura	Para listar repositorios y comprobar si un archivo ya existe
   Repositorios: escritura	Para confirmar el archivo Markdown y sus imágenes

   Haz clic en Conceder acceso.

3. Comprobar la conexión#

   Volverás a Integraciones con el mensaje "Bitbucket conectado correctamente a" seguido de tu nombre de Bitbucket. Bitbucket se moverá a la lista Conectado con una insignia de Conectado. Antes de publicar algo, dirá "Nada publicado aún".

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 Bitbucket 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 el repositorio y la carpeta#

   En Dónde se guarda, elige:

   Campo	Qué elegir	Notas
   Repositorio	El repositorio de Bitbucket para el archivo	Repositorios en los que puedes contribuir, en tus espacios de trabajo de Bitbucket, ordenados por actualización reciente. El primero está seleccionado por defecto
   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 automáticamente

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

   

3. Publicar#

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

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

Dónde va el archivo#

• Rama: la rama principal del repositorio (normalmente main o master). Clevera confirma 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 caracteres latinos, 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 en assets/<file name>/ dentro de la misma carpeta, en la misma confirmación (commit).
• Mensaje de confirmación: Add article: <title>, o Update article: <title> cuando actualizas un archivo existente.
• Autor de la confirmación: la cuenta de Bitbucket que conectó la integración.

Restricciones de rama#

Si el repositorio tiene una restricción de rama en su rama principal (por ejemplo, cambios solo a través de solicitudes de extracción, o escritura limitada a ciertas personas), la confirmación de Clevera será rechazada, por ejemplo con "Necesitas acceso de escritura para confirmar en este repositorio de Bitbucket". Añade la cuenta conectada a las personas que pueden escribir en la rama en Configuración del repositorio → Restricciones de rama, o publica en un repositorio sin esa regla.

Cómo se ve el archivo#

Clevera escribe Markdown plano que la vista de archivos de Bitbucket puede mostrar, con un bloque de metadatos (front matter) corto en la parte superior. No contiene HTML sin procesar, porque Bitbucket no lo renderiza.

---
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#

Si un generador de sitios estáticos (como MkDocs, Docusaurus o Hugo) construye tu documentación desde el repositorio, apunta Carpeta a la carpeta que lee. Cada publicación es una confirmación normal, por lo que Bitbucket Pipelines u otras ejecuciones de compilación funcionan como de costumbre. La mayoría de los generadores leen title de los metadatos (front matter) e ignoran los campos que no conocen.

Actualizar un artículo que ya publicaste#

La publicación solo funciona 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 Bitbucket nunca regresan 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 Bitbucket". Haz clic en Verlo para abrir el archivo existente, luego elige:

Si el título cambió en Clevera, el nombre del archivo también cambia, por lo que la publicación crea un nuevo archivo junto al antiguo. Elimina o renombra el archivo antiguo en Bitbucket tú mismo. Nada en Clevera elimina archivos de tu repositorio.

Desconectar Bitbucket#

1. Abre Integraciones, haz clic en el menú ⋯ en la fila de Bitbucket y elige Desconectar (o haz clic en Bitbucket y luego en Desconectar).
2. Confirma. "Ya no puedes publicar en él desde el editor. El contenido que ya publicaste permanece en Bitbucket."

Desconectar elimina los tokens de Clevera. Para revocar el acceso de Clevera en Bitbucket también, abre tu Configuración personal de Bitbucket, ve a Autorizaciones de aplicaciones y revoca a Clevera.

Solución de problemas#

Relacionado#