Files.md - una app de archivos Markdown local-first y de código abierto como alternativa a Obsidian

 (github.com/zakirullin)
2 puntos por GN⁺ 3 시간 전 | 1 comentarios | Compartir por WhatsApp
  • Una app sencilla de gestión de conocimiento personal que guarda notas, documentos, proyectos, diario, hábitos, listas de verificación y tareas como archivos .md planos
  • Local-first: no requiere instalación, funciona solo con el navegador y puede usarse sin conexión gracias a su estructura PWA
  • Soporte para sincronización por carpetas en la nube: sincroniza entre varios dispositivos usando carpetas existentes de iCloud / Dropbox / Google Drive, sin necesidad de operar un servidor
  • También permite servidor autoalojado: puedes operar tu propio servidor con un único binario de Go, con control total e integración con bot de Telegram
  • Modalidad Hosted (app.files.md): ofrece un servidor administrado para usarlo de inmediato sin configuración
  • Captura rápida: si envías un mensaje en la ventana de chat, se sincroniza automáticamente en todos tus dispositivos, y puedes elegir la ubicación de guardado al instante o organizarla después
    • Notas, tareas, diario y listas de verificación se manejan de una sola vez dentro del mismo flujo. Solo presiona Enter para guardar
  • El Telegram Bot puede usarse para acceder a archivos y guardarlos mientras te desplazas; se planea soporte para otros mensajeros
    • Los elementos de la bandeja de entrada se identifican con un hash de contenido estable (fs.Hash), por lo que, aunque se agreguen, eliminen o completen otros elementos, los botones seguirán apuntando a la línea correcta
  • Su enfoque de gestión del conocimiento enfatiza pensar directamente más que los templates avanzados, plugins o flujos de trabajo con IA, y recomienda un flujo de una idea por nota, enlazar notas relacionadas y revisarlas de nuevo
  • La estructura de archivos viene predefinida como Chat.md, brain/Note.md, journal/2024.08 August.md, habits/*.md, media/*, config.json, pero también puedes usar la estructura que quieras
  • En files.md/llms.txt se proporciona un esquema de la estructura, que puede pegarse en CLAUDE.md o AGENTS.md para que los agentes de IA entiendan la organización de archivos
  • Ofrece atajos para trabajar con archivos Markdown, como insertar enlaces a archivos con [, buscar archivos con Cmd/Ctrl+P y crear archivos nuevos con Cmd/Ctrl+N
  • El código busca ser lo bastante simple como para que una sola persona o un LLM pueda abarcarlo completo mentalmente, y los PR deben priorizar quitar código y simplificar antes que agregar funciones
  • El frontend apunta a que /web/index.html pueda abrirse tal cual incluso con el paso del tiempo, sin sistema de build, y el backend prioriza pruebas, wrapping de errores y dependencias mínimas
  • Todo se guarda en archivos .md normales para priorizar el formato de almacenamiento y la portabilidad, y usa enlaces Markdown estándar para mantener compatibilidad con otros entornos como GitHub
  • Licencia MIT

Lecturas relacionadas

1 comentarios

 
GN⁺ 3 시간 전
Comentarios de Hacker News

  • Me di cuenta una vez más de que Obsidian no es open source, pero curiosamente tiene algo que hace que se sienta como si lo fuera
    Aunque uno revise y vea claramente que no lo es, todavía queda la sensación de que debería ser open source

    • Los datos son abiertos y se guardan en formato Markdown, y los plugins son open source
      El producto principal no es open source, pero al final también es solo una app de Electron, así que siempre he visto a Obsidian como lo opuesto a un producto open core
    • No era la impresión que yo tenía, pero la API para crear plugins es bastante abierta
      En defensa del modelo de Obsidian, tienen un equipo de ingeniería dedicado, la herramienta es gratis y las notas no se guardan en un formato propietario sino en .md
      Si quieres, puedes pagar por la herramienta de sincronización, y me parece que el precio es razonable y una buena forma de apoyar el desarrollo
      El producto además sigue mejorando en direcciones interesantes, y el nuevo marketplace de plugins con políticas de revisión está bastante bien hecho, como para tomarlo como referencia
      En todo caso, este proyecto también se ve bien, aunque yo soy casi un evangelista de Obsidian
    • Para ser justos, Obsidian es una app de Electron no ofuscada, así que es bastante fácil sacar el código
      Incluso recuerdo que el equipo oficial de Obsidian lo sugirió en el foro de soporte, para quien no confíe en la app
    • Precisamente por eso empecé este proyecto hace unos años
      Creo que el software en la era de la IA debería distribuirse como open source
      No debería depender de pasar por un sistema de plugins tosco; cualquiera debería poder modificarlo como quiera
    • No entiendo por qué tendría que ser open source
      Obsidian permite que el usuario tenga control total sobre sus propios datos y los guarda en estándares abiertos
      Me gustaría que me explicaran por qué los desarrolladores tendrían que actuar como monjes que hacen voto de pobreza
      Si los desarrolladores crearon algo valioso, deberían poder obtener beneficios de ello

  • Estoy haciendo una versión nativa de Obsidian con Qt6 (QWidgets, C++)
    Está tomando bastante tiempo recrear el editor Markdown. Hay demasiadas formas de romper los archivos o perder el estilo del Markdown renderizado
    Aun así, hay avances: corre de forma ligera, usa unos 15 MB de RAM, no usa GPU y casi no consume CPU cuando mueves el cursor o haces scroll. Así es como debería comportarse un editor de texto
    Para usarlo como un bloc de notas moderno básico, todavía necesita tablas con widgets, listas y renderizado con resaltado de sintaxis para bloques de código
    No sé si lo voy a publicar como open source. Últimamente parece una pérdida de tiempo, pero sí pienso dejarlo gratis para usar
    https://i.imgur.com/ro9Zq9w.png
    https://i.imgur.com/pbJcTQF.gif

    • Si AI'm building no es un error tipográfico, me gusta bastante como forma de afirmar exactamente que lo estás construyendo con IA
    • Publiqué https://asnotes.io como open source
      Está basado en Markdown y soporta wiki links, gestión de tareas, tableros Kanban y publicación de sitios estáticos
      Corre en local y también se lleva bien con Git
      La idea era construir algo con formatos y tecnologías que probablemente aguanten muchos años
    • Está realmente genial
      Si estás usando Qt, según entiendo, tendrías que pagar la licencia de Qt si piensas distribuir la app como código cerrado
    • Me pregunto si va a ser software libre
      Si haces software libre que sea totalmente compatible con Obsidian y además sea una app nativa, con gusto contribuiría aunque sea con una pequeña cantidad

  • No creo que yo presentaría esto como una alternativa a Obsidian
    Aunque ambos comparten archivos Markdown y los dos son para tomar notas, Files.md parece tener su propia forma de ayudar al usuario a trabajar con pensamientos, notas y conocimiento
    Cuando leí “alternativa”, pensé en paridad de funciones y compatibilidad de API, pero lo que vi en realidad fue algo completamente distinto y mucho más interesante
    Voy a probar el trabajo de un año que hicieron

    • Gracias por la buena observación
      En realidad no lo estamos posicionando como una alternativa a Obsidian. Todavía no sé cuál sería una mejor frase de presentación
      Para mí tiene más que ver con la simplicidad, con un flujo donde puedes agregar algo sin complicarte, y con que esté listo para usar de inmediato
      La idea es enfocarse no en algo vistoso, sino en algo que realmente funcione
    • Algo como “notas Markdown autohospedadas que posees por completo” o “servidor personal de conocimiento” podría funcionar
      Eso pondría más énfasis en la propiedad que en competir con Obsidian por funciones
    • Apenas leí la palabra “alternativa”, de inmediato me vino a la cabeza la típica queja sobre la gente que llama alternativa a cosas que no lo son

  • Joplin es open source, configurar la sincronización entre dispositivos es tan fácil como iniciar sesión una vez en Dropbox y funciona gratis
    También tiene apps nativas para Windows, macOS, Linux, iOS y Android, y bastantes plugins
    Si lo único que necesitas son archivos Markdown sincronizados, usa esto en vez de pagar por Obsidian Sync
    Los 2 GB gratis de Dropbox alcanzan bien para texto y algunas capturas de pantalla. Claro, también puedes alojarlo tú mismo
    Git es excelente para código fuente, pero para notas es engorroso

    • Salvo que no se guardan como archivos Markdown editables directamente en disco, sino en SQLite
    • Ya no uso Dropbox, pero da gusto saber que todavía ofrecen esa cantidad de espacio
      Yo uso Git y me funciona bien, además me da tranquilidad saber que mis notas no van a desaparecer
      Antes era más difícil en móvil, así que usaba una app dedicada, pero ahora Obsidian Git también funciona suficientemente bien
      Todavía hay margen para mejorar, pero en general me basta
      Suelo dictar cosas a la nota diaria en el teléfono y luego las organizo mejor en el escritorio

  • Me parece interesante que algunas versiones de la idea de second brain digan que “el second brain crece, pero el first brain no se vuelve más inteligente”
    Recuerdo que Tiago Forte describía el objetivo de su second brain como “no recordar nada”
    La idea sería que, cuando lo necesites, el second brain te muestre el contexto exacto para leerlo y absorberlo, pero ese comentario me quitó bastante interés por toda esa marca
    Me suena parecido a eso de “si puedes encontrarlo en Google, no necesitas recordarlo”, y no me convence
    Me gusta mucho más la visión de este autor, que usa el first brain como algo que se fortalece con ayuda del second brain

    • Sé que es imposible recordarlo todo
      La gente ya es bastante mala para recordar con precisión incluso lo que vio hace unos minutos
      Pero si no recuerdas nada y solo tiras todo al second brain, te quedas sin mapa, sin contexto y sin saber cómo encontrar lo que necesitas en el momento
      Es algo parecido a ponerle un libro de texto de electrónica en la mano a cualquier adolescente que pase por la calle y pedirle que arme una fuente de poder ahí mismo
      Al final claramente hay un espectro, y todos piensan distinto sobre cuál es el punto óptimo. Casi seguro cambia mucho de persona a persona
      En lo personal, el simple hecho de escribir notas muy detalladas desde el principio ya hace que la información se me quede mucho más pegada en la cabeza, y aumenta bastante la probabilidad de que después ni siquiera necesite consultar las notas directamente
      Es un dilema pequeño pero interesante
    • Gracias
      Llevo años haciendo crecer mi base de conocimiento y me ha dado buenos resultados
      No se necesita mucho para empezar a tomar notas
      No hacen falta técnicas ni workflows; con la configuración más simple basta
      Lo que pasa es que “Second Brain” es una expresión que entusiasma a la gente
      En la práctica no funciona tan bien, pero para vender es excelente

  • No basta con poseer datos en archivos de texto plano; también deberías poseer el software que abre esos archivos
    Así los archivos y las herramientas pueden crecer juntos con el tiempo, completamente bajo tu control
    Esta app está hecha para que sea fácil modificarla según tus necesidades con un LLM, y el código también está optimizado para eso
    Además, Go parece encajar muy bien en este tipo de software

  • El enfoque de una interfaz de chat me parece interesante
    Ahora que los asistentes de IA ya arrancaron en serio, parece algo viable

  • Puede que Obsidian no sea open source, pero su formato de archivo es definitivamente más abierto que el de Joplin
    Por eso me cambié a Obsidian
    Si sincronizas con Syncthing, funciona lo suficientemente bien tanto en escritorio como en smartphone

  • Lo que todavía me falta en la mayoría de las herramientas Markdown es una buena capacidad para renderizar y compartir documentos grandes de arquitectura y diagramas Mermaid
    Al final hice mi propio lector de archivos Markdown, https://mdview.io, que maneja diagramas y tablas grandes mucho mejor que una app de notas típica

    • Estoy usando un script sencillo que previsualiza páginas Markdown como HTML y las hospeda con un servidor en vivo para que se actualicen dinámicamente
      Renderiza Mermaid, resaltado de sintaxis y demás
      Es muy útil para planear software junto con agentes
      También ayuda mucho ver que la página se va actualizando dinámicamente mientras trabajas y que los diagramas aparecen
      Últimamente estoy incluyendo diagramas con mucha más frecuencia en los prompts, ya sea en la etapa de planificación o cuando hace falta

  • Mejor usa LogSeq: https://discuss.logseq.com/t/whats-new-with-logseq-db-may-16...

    • Esa función de Markdown mirror está bastante buena
      Yo he usado Trilium para mis notas y la app en sí me gusta, pero una de las cosas que no me convence es cómo guarda y almacena las notas
      Una vez exporté todo a Markdown y sí funcionó
      Pero Trilium te deja poner notas en varias ubicaciones, y en el backend eso existe básicamente como punteros que apuntan a esa nota
      Entonces la exportación se volvió un poco rara, y algunas instancias de notas terminaban como cascarones vacíos sin el contenido real
      Al final tuve que ir moviendo notas para que los archivos Markdown quedaran en los lugares correctos
      Aun así, me gusta poder tener notas en varias ubicaciones de esta forma, así que al final seguí usando Trilium