← Volver a la caja de herramientas ✏️ Guía práctica

Qué es HedgeDoc: editor colaborativo en Markdown sin Google

Colaboración Markdown Tiempo real Registro bajo petición Software libre

HedgeDoc es un editor colaborativo en tiempo real donde varias personas pueden escribir en el mismo documento a la vez. Funciona en el navegador, usa Markdown, y cada documento tiene su propia URL para compartir. La instancia de TuiterRocks está en docs.tuiter.ovh, con registro cerrado y acceso bajo petición.

✏️ Qué es HedgeDoc y para qué sirve

Cuando necesitas escribir algo con otra persona, lo más habitual es acabar en Google Docs. Funciona, sí. Pero implica una cuenta de Google, que el documento viva en sus servidores y que el historial de edición quede vinculado a perfiles reales.

HedgeDoc es una alternativa libre para escritura colaborativa puntual o continuada. Creas un documento, ajustas sus permisos, compartes el enlace, y otras personas pueden leerlo o editarlo según la configuración que hayas elegido. Los cambios aparecen en tiempo real para todas las personas que tienen el documento abierto.

Para qué encaja bien: borradores conjuntos, notas de reunión, guías en proceso, cualquier texto que varias personas necesiten tocar a la vez o por turnos. No es un sustituto de un procesador de texto completo ni de un gestor documental, pero para redacción colaborativa hace exactamente lo que promete.

Eso sí: no es una herramienta para guardar contraseñas, claves privadas ni documentos especialmente sensibles. HedgeDoc está pensado para colaborar escribiendo, no para actuar como caja fuerte cifrada.

🔑 Cómo funciona el registro

La instancia de TuiterRocks no tiene registro abierto, pero cualquiera puede pedir acceso. El registro está cerrado para evitar spam y documentos abandonados, no para limitar el uso: si necesitas un pad colaborativo y quieres usarlo en un entorno comunitario, puedes pedirlo.

Dos formas de hacerlo:

No hace falta ser usuaria de la instancia de Mastodon.

Sobre los permisos: para crear documentos propios hace falta cuenta. Para leer un documento concreto, no siempre: si quien lo ha creado lo configura como público o accesible mediante enlace, otra persona puede abrirlo desde el navegador sin tener cuenta en la instancia. Esto no significa que todas las notas sean públicas: cada documento tiene sus propios permisos, y por defecto la instancia está configurada de forma prudente para evitar exposición accidental de borradores o documentos internos.

▶ Cómo se usa: crear y compartir un documento

  1. Abre la instancia Ve a docs.tuiter.ovh e inicia sesión con tu cuenta.

  2. Crea un documento nuevo Una vez dentro, crea una nota nueva desde la pantalla inicial o desde el menú de la aplicación. Se abrirá un editor vacío con su propia URL.

  3. Escribe en Markdown El editor tiene dos columnas: código a la izquierda, vista previa a la derecha. También puedes cambiar a modo presentación o modo solo lectura desde el menú superior.

  4. Configura los permisos Desde el menú del documento puedes elegir quién puede leer y quién puede editar: solo tú, cualquiera con el enlace, o cualquiera registrada en la instancia.

  5. Comparte el enlace Copia la URL del documento y compártela. Quien la reciba podrá abrirlo o editarlo según los permisos que hayas configurado.

Los cambios se guardan automáticamente. No hace falta pulsar ningún botón para no perder el trabajo.

📝 Qué puedes hacer con Markdown en HedgeDoc

HedgeDoc usa Markdown estándar con algunas extensiones. Lo habitual funciona sin tener que aprender nada especial: encabezados con #, listas con -, negrita con **texto**, enlaces con [texto](url). Además de eso, admite bloques de código con resaltado de sintaxis, tablas, listas de tareas con casillas de verificación, fórmulas matemáticas en LaTeX y diagramas con Mermaid.

Para quien no conoce Markdown, la curva de aprendizaje es corta. La vista previa en tiempo real ayuda a ver el resultado sin tener que memorizar la sintaxis.

📊 HedgeDoc frente a Google Docs y Etherpad

← desliza para ver toda la tabla →

Google DocsEtherpadHedgeDoc
Colaboración en tiempo real
Requiere cuenta para crear documentosDepende de la instalaciónDepende de la instancia
Formato de texto enriquecidoSí (WYSIWYG)BásicoSí (Markdown)
Diagramas y fórmulasCon pluginsNo
Exportar a PDF / HTMLLimitado
Software libreNo
AutoalojableNo
Dependencia de cuenta corporativa externaSí, normalmente GoogleNoNo, si se usa instancia propia o comunitaria

HedgeDoc no compite en funciones de procesador de texto: no tiene estilos de párrafo, comentarios en línea ni revisión con control de cambios. Para redacción colaborativa en Markdown, con soporte para diagramas y sin depender de infraestructura de Google, es una opción sólida.

🛠 Sección técnica: autoalojamiento

Si solo quieres usar la instancia de TuiterRocks, no necesitas instalar nada. Esta sección es para quien quiera montar su propio HedgeDoc en un servidor.

HedgeDoc es software libre mantenido por su comunidad. El repositorio oficial está en GitHub y la documentación de instalación en docs.hedgedoc.org.

Requisitos básicos

HedgeDoc necesita Node.js, una base de datos (PostgreSQL recomendado para producción, SQLite para instalaciones pequeñas) y un servidor web como proxy inverso (nginx o Apache). La forma más habitual de instalarlo es con Docker Compose.

Instalación con Docker Compose

La configuración mínima oficial usa dos contenedores: uno para la base de datos PostgreSQL y otro para la aplicación.

docker-compose.yml services:
  database:
    image: postgres:17-alpine
    environment:
      – POSTGRES_USER=hedgedoc
      – POSTGRES_PASSWORD=cambia_esta_contraseña
      – POSTGRES_DB=hedgedoc
    volumes:
      – database:/var/lib/postgresql/data
    restart: always

  app:
    # Consulta la versión estable actual en https://hedgedoc.org/latest-release
    image: quay.io/hedgedoc/hedgedoc:1.10.8
    environment:
      – CMD_DB_URL=postgres://hedgedoc:cambia_esta_contraseña@database:5432/hedgedoc
      – CMD_DOMAIN=docs.tudominio.org
      – CMD_URL_ADDPORT=false
      – CMD_PROTOCOL_USESSL=true
    volumes:
      – uploads:/hedgedoc/public/uploads
    ports:
      – «3000:3000»
    restart: always
    depends_on:
      – database

volumes:
  database:
  uploads:

Con esta configuración, docker compose up -d levanta la instancia en el puerto 3000. Para producción conviene poner nginx delante como proxy inverso y gestionar los certificados TLS por separado.

Variables de entorno clave

Variables de entorno relevantes CMD_DOMAIN              # dominio donde va a estar accesible la instancia
CMD_PROTOCOL_USESSL     # actívalo si el proxy inverso gestiona HTTPS
CMD_ALLOW_ANONYMOUS     # controla si se permite acceso anónimo a la instancia
CMD_ALLOW_ANONYMOUS_EDITS # ediciones anónimas cuando el documento lo permite
CMD_ALLOW_FREEURL       # permite crear documentos con URLs personalizadas
CMD_DEFAULT_PERMISSION   # freely | editable | limited | locked | private

La lista completa está en la documentación de configuración oficial.

Actualizaciones

Actualizar la instancia docker compose pull
docker compose up -d

❓ Preguntas frecuentes

¿Hace falta cuenta para leer un documento de HedgeDoc?

Depende de los permisos que haya configurado quien lo creó. Si el documento es público o accesible con enlace, se puede leer sin cuenta. Para crear documentos propios sí hace falta registro en nuestra instancia.

¿Los documentos se guardan automáticamente?

Sí. HedgeDoc guarda los cambios de forma continua. No hay botón de guardar porque no hace falta.

¿Puedo exportar un documento?

Sí. Desde el menú del documento puedes exportar a Markdown, HTML, PDF y otros formatos.

¿Qué pasa si varias personas editan a la vez?

Los cambios se sincronizan en tiempo real para todas las personas que tienen el documento abierto. Cada cursora aparece con un color distinto para saber quién está editando qué.

¿HedgeDoc cifra los documentos?

No. HedgeDoc no ofrece cifrado de extremo a extremo en el navegador. Los documentos se almacenan en el servidor y quien administra la instancia tiene acceso técnico al contenido. Para contraseñas, claves privadas, datos personales delicados o documentos realmente sensibles, es mejor usar otra herramienta como PrivateBin u otro sistema con cifrado de extremo a extremo.

¿Quieres usar HedgeDoc en TuiterRocks? El registro no está abierto para evitar spam y documentos abandonados, pero podemos crear cuentas a personas y proyectos que quieran usarlo de forma razonable.

Deja un comentario