Ir al contenido principal
Integración

Guía de Integración de TaskNotes: Una Tarea Por Archivo con Frontmatter YAML

Descubre cómo TaskForge soporta el formato TaskNotes para Obsidian, permitiéndote gestionar tareas con una tarea por archivo usando frontmatter YAML. Perfecto para documentación detallada de tareas, metadatos enriquecidos y flujos de trabajo estructurados de toma de notas.

Integración de TaskForge con TaskNotes en macOS mostrando una tarea por archivo con frontmatter YAML
Ver Todas las Funciones

¿Qué es el Formato TaskNotes?

TaskNotes es un formato de gestión de tareas que almacena una tarea por archivo usando frontmatter YAML para los metadatos. A diferencia de las tareas en línea dispersas en tus notas, TaskNotes le da a cada tarea su propio archivo dedicado con propiedades estructuradas y mucho espacio para documentación detallada.

Una Tarea Por Archivo

Cada tarea vive en su propio archivo markdown, dándote espacio ilimitado para notas, adjuntos y documentación.

Frontmatter YAML

Almacena metadatos de tareas en frontmatter YAML estructurado para estado, prioridad, fechas, etiquetas y propiedades personalizadas.

Identificación Flexible

Identifica TaskNotes por etiqueta o propiedad personalizada. Elige el método que mejor se adapte a tu flujo de trabajo.

Carpetas Configurables

Establece una carpeta predeterminada para nuevas TaskNotes y organízalas de la manera que funcione para la estructura de tu vault.

Ejemplo de Archivo TaskNotes

Así es como se ve un archivo TaskNotes típico en tu vault de Obsidian:

---
status: in-progress
priority: high
due: 2025-10-15
tags:
  - work
  - project-alpha
created: 2025-10-01
---

# Review PR #123

Review the new authentication system PR and provide feedback on:

- [ ] Code quality and patterns
- [ ] Test coverage
- [ ] Documentation completeness
- [ ] Security considerations

## Notes

- Need to verify the new token refresh logic
- Check that rate limiting is properly implemented
- Test with various user permission levels

## Links

- [[Authentication Design Doc]]
- [[Security Guidelines]]

Propiedades Soportadas

Estado

Estado de completación de la tarea: por hacer, en progreso, en espera, planificada o hecha

status: in-progress

Prioridad

Importancia de la tarea: muy alta, alta, media, baja o muy baja

priority: high

Fechas

Fechas de vencimiento, fechas programadas, fechas de inicio y fechas de completación

due: 2025-10-15 scheduled: 2025-10-10 start: 2025-10-01

Etiquetas

Organiza tareas con múltiples etiquetas en formato de lista

tags:
  - work
  - urgent
  - project-alpha

Recurrencia

Configura tareas recurrentes con intervalos flexibles

recurrence: every week

Configurando TaskNotes

  1. 1

    Enable Archivos de Tareas

    Open Configuración > Tipos de Tareas, toggle 'Archivos de Tareas' on, then tap 'Configuración de Archivos de Tareas' to configure identification, default folder, and field mapping.

  2. 2

    Elegir Método de Identificación

    Selecciona cómo TaskForge debe identificar archivos TaskNotes: por una etiqueta específica (ej., #task) o por una propiedad personalizada (ej., type: task).

  3. 3

    Establecer Carpeta Predeterminada

    Elige una carpeta predeterminada donde se deben crear las nuevas TaskNotes. Esto ayuda a mantener tu vault organizada.

  4. 4

    Elegir Formato Predeterminado

    Decide si las nuevas tareas deben crearse como TaskNotes o tareas en línea de forma predeterminada. Siempre puedes anular esto por lista personalizada.

  5. 5

    Personalizar Mapeo de Campos (Opcional)

    Avanzado: Personaliza los nombres de las propiedades YAML si usas nombres de campos diferentes en tu vault.

TaskNotes vs. Tareas en Línea

Usa TaskNotes Cuando:

  • Necesitas documentación detallada de tareas
  • Las tareas requieren múltiples notas y adjuntos
  • Prefieres metadatos estructurados
  • Las tareas son proyectos complejos
  • Quieres archivos de tareas con búsqueda

Usa Tareas en Línea Cuando:

  • Las tareas son elementos de acción simples
  • Las tareas pertenecen a notas de reuniones
  • Prefieres tareas integradas en contexto
  • La captura rápida es prioridad
  • Usas el plugin Obsidian Tasks

Buenas noticias: ¡No tienes que elegir! TaskForge soporta ambos formatos. Usa TaskNotes para proyectos grandes y tareas en línea para elementos de acción rápidos - todo en una lista de tareas unificada.

Que funciones avanzadas de TaskNotes estan disponibles?

Mas alla de lo basico de la gestion de una tarea por archivo, TaskNotes ofrece varias funciones avanzadas que te permiten adaptar el sistema a tu flujo de trabajo exacto. Estas opciones son especialmente utiles si ya tienes una estructura de vault establecida o convenciones especificas para organizar tus notas.

Mapeo de campos personalizado

Si tu vault ya usa nombres de propiedades YAML diferentes, no necesitas cambiarlos. TaskForge te permite reasignar sus nombres de campo predeterminados para que coincidan con los tuyos. Por ejemplo, si usas 'state' en lugar de 'status' o 'importance' en lugar de 'priority', puedes configurar TaskForge para leer y escribir esos campos directamente. Esto significa que puedes adoptar TaskNotes sin reestructurar un solo archivo existente.

Formatos de nombre de archivo personalizados

Controla exactamente como se nombran los nuevos archivos TaskNotes usando variables como {title}, {date} y {priority}. Por ejemplo, podrias establecer el formato como '{date}-{title}' para que cada archivo de tarea comience con su fecha de creacion, facilitando la clasificacion cronologica en el explorador de archivos de Obsidian.

Plantillas de cuerpo

Define una plantilla de cuerpo markdown predeterminada que se inserta en cada nuevo archivo TaskNotes. Si siempre quieres una seccion de Notas, una seccion de Lista de verificacion y una seccion de Enlaces en tus archivos de tareas, configura una plantilla una vez y cada nueva tarea comenzara con esa estructura. Las plantillas te ahorran escribir el mismo contenido repetitivo una y otra vez.

Proyectos y contextos

TaskNotes soporta anotaciones de proyecto y contexto usando la sintaxis +NombreProyecto y @contexto. Etiqueta una tarea con +RedisenoWeb para vincularla a un proyecto especifico, o @oficina para indicar donde debe realizarse el trabajo. Estas anotaciones funcionan junto con las etiquetas regulares, brindandote una forma mas rica de categorizar y filtrar tareas en tu vault.

Como migrar de tareas en linea a TaskNotes?

Si has estado usando tareas en linea y quieres comenzar a aprovechar TaskNotes, la buena noticia es que no tienes que cambiar todo de una vez. TaskForge soporta ambos formatos simultaneamente, por lo que puedes migrar gradualmente a tu propio ritmo.

1

Comienza con tareas complejas

Los mejores candidatos para la migracion son tareas que han superado una sola linea. Si te encuentras agregando descripciones largas, multiples subtareas o enlaces de referencia a una tarea en linea, esa tarea es un candidato natural para el formato TaskNotes donde obtiene su propio archivo y espacio ilimitado para documentacion.

2

Manten las tareas simples en linea

No todas las tareas necesitan su propio archivo. Acciones rapidas como 'Comprar viveres' o 'Responder al correo de Sara' funcionan perfectamente como tareas en linea. Reserva el formato TaskNotes para tareas que genuinamente se benefician de metadatos estructurados y notas detalladas.

3

Usa ambos formatos simultaneamente

TaskForge muestra tareas en linea y TaskNotes juntas en la misma lista de tareas unificada. No necesitas preocuparte por mezclar formatos: ambos tipos aparecen en tus listas personalizadas, vistas de calendario y widgets. La aplicacion maneja la diferencia entre bastidores para que puedas concentrarte en tu trabajo.

4

Organiza TaskNotes en una carpeta dedicada

Crea una carpeta dedicada en tu vault para archivos TaskNotes, como 'Tasks' o 'TaskNotes'. Esto mantiene tu vault ordenado y facilita encontrar archivos de tareas en el explorador de archivos de Obsidian. Establece esta carpeta como la ubicacion predeterminada en la configuracion de TaskForge para que cada nuevo archivo TaskNotes se guarde automaticamente en el lugar correcto.

5

Migra por lotes

En lugar de convertir todas tus tareas en linea de una vez, elige un proyecto o un area de tu vida para migrar primero. Mueve tus tareas de trabajo a TaskNotes durante una semana y ve como se siente. Una vez que te sientas comodo con el flujo de trabajo, expandete a otras areas. Este enfoque gradual te permite perfeccionar tu mapeo de campos y plantillas antes de comprometerte completamente.

¿Listo para Probar TaskNotes?

Descarga TaskForge y comienza a usar el formato TaskNotes para tus flujos de trabajo de gestión detallada de tareas en Obsidian. Conoce todas las capacidades de TaskNotes en nuestra página de funciones , y descubre las últimas mejoras de TaskNotes para las actualizaciones recientes.

Azhar Dewji
Azhar Dewji · · Updated July 8, 2026

Ingeniero de software con más de 10 años de experiencia desarrollando apps móviles y de escritorio en Swift, Kotlin y Flutter. Desarrollador independiente radicado en Toronto, Canada. Creador de TaskForge. Conoce más