Mejores plataformas de Documentación y notas
Documenta tu producto y organiza tu conocimiento.
7 plataformas · filtrar y buscar
Documentar es lo primero que se abandona y lo primero que echas de menos. No hablamos de manuales enormes: hablamos de saber, dentro de seis meses, por qué decidiste una cosa y no otra, cómo se despliega el proyecto y qué ya probaste que no funcionaba.
En esta categoría conviven tres cosas distintas: apps de notas personales, wikis de equipo y herramientas para publicar documentación de producto. Comparten aire pero resuelven problemas diferentes, y la que es excelente en una suele ser mediocre en las otras.
La pregunta que más ordena la elección es dónde quieres que vivan tus archivos: en la nube de otro, o en tu disco en formato abierto.
Notion
notion.com
Espacio de trabajo todo-en-uno para notas, documentación, wikis y gestión de proyectos.
Obsidian
obsidian.md
Notas en Markdown guardadas en local, con backlinks y un enorme ecosistema de plugins.
Confluence
atlassian.com
Wiki empresarial de Atlassian, integrada con Jira y el resto de su suite.
Docusaurus
docusaurus.io
Generador open source de sitios de documentación de Meta, basado en React y MDX.
GitBook
gitbook.com
Documentación de producto con acabado cuidado, sincronizada con tus repositorios git.
Mintlify
mintlify.com
Documentación de API y producto a partir de MDX, con un acabado visual muy cuidado.
Outline
getoutline.com
Wiki de equipo rápida y ordenada, open source y con opción de auto-hospedaje.
Cómo elegir: Documentación y notas
Para ti solo o para un equipo
Las notas personales piden rapidez al escribir, búsqueda instantánea y que nadie te interrumpa. La documentación de equipo pide permisos, comentarios y edición a la vez. Son productos distintos aunque se parezcan, y forzar uno a hacer el trabajo del otro se nota enseguida.
Dónde viven tus archivos
Unas herramientas guardan todo en su nube y son cómodas hasta el día que quieres salir. Otras guardan archivos Markdown en tu disco, que puedes versionar con git y abrir con cualquier editor dentro de veinte años. Si tu conocimiento es un activo a largo plazo, esto pesa más de lo que parece.
Si además tiene que ser pública
Documentar tu producto de cara al usuario es otro problema: quieres URLs limpias, buscador, versiones y que Google lo indexe. Algunas herramientas publican con un clic; otras están pensadas solo para uso interno y forzarlas a ser web pública sale mal.
Exportar sin perder nada
Antes de meter cinco años de conocimiento, comprueba cómo se sale: si exporta a Markdown limpio, si mantiene los enlaces internos y si arrastra las bases de datos y las tablas. La exportación es la única garantía real de que no te has atado.
Preguntas frecuentes
¿Notas en la nube o archivos en local?
En la nube ganas colaboración, acceso desde cualquier sitio y publicar con un clic. En local ganas velocidad, control total y la seguridad de que tus archivos son tuyos aunque la empresa cierre. Mucha gente acaba usando las dos: local para pensar, nube para compartir.
¿Sirve una de estas para la documentación pública de mi producto?
Algunas sí y están diseñadas para eso, con buscador, versiones y buen SEO. Otras son herramientas internas y publicar con ellas da URLs feas y páginas que Google indexa mal. Mira en la ficha de cada una si la publicación pública es una función de primera o un añadido.
¿Merece la pena tener una wiki siendo yo solo?
Sí, sobre todo para lo que no está en el código: por qué tomaste una decisión, cómo se despliega, qué probaste que no funcionó. Es exactamente lo que se te va a olvidar en seis meses y lo que no puedes deducir mirando el repositorio.
¿Ya usas una y buscas otra cosa?
Para cada una tienes su página de alternativas, con el motivo habitual por el que la gente se va y qué más hay en documentación y notas.
Rutas que usan estas herramientas
Actualizado el