Docker. Flatnotes tomando notas en markdown. uGeek Blog

Flatnotes es una aplicación web de toma de notas que se autohospeda y que utiliza archivos markdown para almacenar tus notas. Esta aplicación sin base de datos está diseñada para ser un entorno libre de distracciones que prioriza el contenido de tus notas. La aplicación cuenta con una interfaz de usuario limpia y sencilla que te permite acceder a todas tus notas con facilidad. También puedes utilizar las potentes funcionalidades de búsqueda y etiquetado para buscar notas rápidamente y fácilmente.

En este artículo, te explicaremos las características principales de Flatnotes y cómo puedes instalarla y usarla en tu propio servidor. También te mostraremos algunos ejemplos de cómo puedes crear y editar tus notas con Flatnotes.

Características principales de Flatnotes

El principal objetivo de Flatnotes es priorizar tus notas proporcionando una interfaz sencilla. No se incorporan sistemas complejos como directorios de archivos o libretas. En su lugar, almacena todas tus notas en archivos markdown que se organizan planamente, para que puedas acceder a ellas rápidamente. La función de búsqueda facilita la búsqueda de títulos y texto dentro de las notas para obtener resultados muy precisos.

Otro principio importante de diseño de Flatnotes es que no toma tus notas como rehenes. Tus notas son simplemente archivos markdown, lo que significa que eres libre de moverlas a otra aplicación o ubicación de almacenamiento en cualquier momento sin ningún problema. La aplicación no utiliza un sistema de formato propietario ni estructuras complicadas de carpetas, que a menudo dificultan el traslado de tus notas a otra aplicación o ubicación.

La única cosa que Flatnotes almacena en caché es el índice de búsqueda, que se sincroniza incrementalmente en cada búsqueda y cuando se inicia la aplicación. Esto significa que eres libre de añadir, editar y eliminar archivos markdown fuera de Flatnotes, incluso mientras la aplicación está funcionando. Esta es una gran ventaja si quieres trabajar en tus notas usando una aplicación diferente o editarlas directamente en un editor de texto.

Cómo instalar Flatnotes

Flatnotes se puede instalar fácilmente usando Docker Compose. Aquí tienes un ejemplo del archivo docker-compose.yml que puedes usar para ejecutar Flatnotes:

Docker Compose

FlatNotes con usuario y contraseña

  flatnotes:
    container_name: flatnotes
    image: dullage/flatnotes
    environment:
      FLATNOTES_AUTH_TYPE: "password"
      FLATNOTES_USERNAME: "angel"
      FLATNOTES_PASSWORD: "contraseña"
#      FLATNOTES_AUTH_TYPE: "none"
      FLATNOTES_SESSION_EXPIRY_DAYS: "365"
      FLATNOTES_SECRET_KEY: "aLongRandomSeriesOfCharacters"
    volumes:
      - "./data:/data"
      # Optional. Allows you to save the search index in a different location:
      - "./flatnotes/index:/data/.flatnotes"
    ports:
      - "8080:8080"
    restart: unless-stopped

FlatNotes con usuario, contraseña y 2FA

Puedes personalizar las variables del entorno según tus preferencias. Por ejemplo, puedes cambiar el nombre del usuario y la contraseña o usar autenticación basada en tokens en lugar del tipo password.Una vez tengas el archivo docker-compose.yml listo, solo tienes que ejecutar el siguiente comando para iniciar Flatnotes:

docker-compose up -d

Ahora podrás acceder a la interfaz web desde tu navegador usando la dirección IP o el dominio del servidor donde has instalado Flatnotes.

Cómo usar Flatnotes

Para empezar a usar Flatnotes solo tienes que iniciar sesión con las credenciales que has configurado previamente e ir al panel principal donde verás todas tus notas existentes (si las hay) ordenadas por fecha.Para crear una nueva nota solo tienes que hacer clic en el botón + situado en la parte superior derecha e introducir un título y un contenido para tu nota usando el formato markdown. Puedes usar los botones situados debajo del campo del título para aplicar diferentes formatos al texto seleccionado (negrita, cursiva, encabezados, listas…). También puedes insertar imágenes arrastrándolas desde tu ordenador o pegándolas desde el portapapeles.Para guardar tu nota solo tienes que hacer clic en el botón Guardar situado también en la parte superior derecha o pulsar Ctrl+S (Cmd+S si usas Mac).Para editar una nota existente solo tienes que hacer clic sobre ella desde el panel principal

Etiquetas

Podemos añadir etiquetas a nuestras notas para después hacer una búsqueda más selectiva. Para añadir la etiqueta utilizaremos # seguido el nombre de etiqueta. Ejemplo: #etiqueta

WYSIWYG

En un editor de texto, WYSIWYG es un acrónimo de "What You See Is What You Get" (lo que ves es lo que obtienes, en español). Se refiere a la capacidad del editor de texto para mostrar el resultado final del documento mientras se está editando, lo que significa que el usuario no tiene que preocuparse por el código subyacente o la estructura del documento. En cambio, el usuario puede centrarse en el contenido y el formato del documento, y el editor se encarga de la presentación final. Por otro lado, Markdown es un lenguaje de marcado ligero. A diferencia de los editores WYSIWYG, los editores de Markdown muestran el código subyacente mientras se está editando, lo que permite a los usuarios ver y editar el código directamente. Sin embargo, el resultado final del documento se ve igual que en un editor WYSIWYG, lo que significa que los usuarios pueden centrarse en el contenido y el formato del documento sin preocuparse por el código subyacente

Flatnotes tomando notas en markdown

Tiempo estimado de lectura: 8 minutos. 989 palabras. markdown