Saltar al contenido principal
Integración

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

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

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

¿Qué es el Formato TaskNotes?

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

Una Tarea Por Archivo

Cada tarea reside en su propio archivo markdown, proporcionándole espacio ilimitado para notas, adjuntos y documentación.

Frontmatter YAML

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

Identificación Flexible

Identifique TaskNotes por etiqueta o propiedad personalizada. Elija el método que mejor se adapte a su flujo de trabajo.

Carpetas Configurables

Establezca una carpeta predeterminada para nuevas TaskNotes y organícelas de la manera que funcione para la estructura de su vault.

Ejemplo de Archivo TaskNotes

Así es como se ve un archivo TaskNotes típico en su 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 completitud de la tarea: todo, in-progress, on-hold, planned o done

status: in-progress

Prioridad

Importancia de la tarea: highest, high, medium, low o lowest

priority: high

Fechas

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

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

Etiquetas

Organice tareas con múltiples etiquetas en formato de lista

tags:
  - work
  - urgent
  - project-alpha

Recurrencia

Configure tareas recurrentes con intervalos flexibles

recurrence: every week

Configuración de TaskNotes

  1. 1

    Enable Archivos de Tareas

    Open Ajustes > 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

    Seleccione cómo TaskForge debería identificar archivos TaskNotes: mediante una etiqueta específica (p. ej., #task) o mediante una propiedad personalizada (p. ej., type: task).

  3. 3

    Establecer Carpeta Predeterminada

    Elija una carpeta predeterminada donde se deberían crear las nuevas TaskNotes. Esto ayuda a mantener su vault organizada.

  4. 4

    Elegir Formato Predeterminado

    Decida si las nuevas tareas deberían crearse como TaskNotes o tareas en línea por defecto. Siempre puede anular esto por lista personalizada.

  5. 5

    Personalizar Mapeo de Campos (Opcional)

    Avanzado: Personalice los nombres de las propiedades YAML si utiliza nombres de campos diferentes en su vault.

TaskNotes vs. Tareas en Línea

Use TaskNotes Cuando:

  • Necesite documentación detallada de tareas
  • Las tareas requieran múltiples notas y adjuntos
  • Prefiera metadatos estructurados
  • Las tareas sean proyectos complejos
  • Desee archivos de tareas con búsqueda

Use Tareas en Línea Cuando:

  • Las tareas sean elementos de acción simples
  • Las tareas pertenezcan a notas de reunión
  • Prefiera tareas incrustadas en contexto
  • La captura rápida sea prioritaria
  • Utilice el plugin Obsidian Tasks

Buenas noticias: ¡No tiene que elegir! TaskForge soporta ambos formatos lado a lado. Use 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 le permiten adaptar el sistema a su flujo de trabajo exacto. Estas opciones son especialmente utiles si ya tiene una estructura de vault establecida o convenciones especificas para organizar sus notas.

Mapeo de campos personalizado

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

Formatos de nombre de archivo personalizados

Controle exactamente como se nombran los nuevos archivos TaskNotes usando variables como {title}, {date} y {priority}. Por ejemplo, podria establecer el formato como '{date}-{title}' para que cada archivo de tarea comience con su fecha de creacion, facilitando la clasificacion cronologica de archivos en el explorador de archivos de Obsidian. Esto es especialmente util para personas que dependen de convenciones de nombres basadas en fechas.

Plantillas de cuerpo

Defina una plantilla de cuerpo markdown predeterminada que se inserta en cada nuevo archivo TaskNotes. Si siempre desea una seccion de Notas, una seccion de Lista de verificacion y una seccion de Enlaces en sus archivos de tareas, configure una plantilla una vez y cada nueva tarea comenzara con esa estructura. Las plantillas le 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. Etiquete 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, brindandole una forma mas rica de categorizar y filtrar tareas en su vault.

Como migrar de tareas en linea a TaskNotes?

Si ha estado usando tareas en linea y quiere comenzar a aprovechar TaskNotes, la buena noticia es que no tiene que cambiar todo de una vez. TaskForge soporta ambos formatos simultaneamente, por lo que puede migrar gradualmente a su propio ritmo.

1

Comience con tareas complejas

Los mejores candidatos para la migracion son tareas que han superado una sola linea. Si se encuentra 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

Mantenga 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. Reserve el formato TaskNotes para tareas que genuinamente se benefician de metadatos estructurados y notas detalladas.

3

Use ambos formatos simultaneamente

TaskForge muestra tareas en linea y TaskNotes juntas en la misma lista de tareas unificada. No necesita preocuparse por mezclar formatos: ambos tipos aparecen en sus listas personalizadas, vistas de calendario y widgets. La aplicacion maneja la diferencia entre bastidores para que pueda concentrarse en su trabajo.

4

Organice TaskNotes en una carpeta dedicada

Cree una carpeta dedicada en su vault para archivos TaskNotes, como 'Tasks' o 'TaskNotes'. Esto mantiene su vault ordenado y facilita encontrar archivos de tareas en el explorador de archivos de Obsidian. Establezca 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

Migre por lotes

En lugar de convertir todas sus tareas en linea de una vez, elija un proyecto o un area de su vida para migrar primero. Mueva sus tareas de trabajo a TaskNotes durante una semana y vea como se siente. Una vez que se sienta comodo con el flujo de trabajo, expandase a otras areas. Este enfoque gradual le permite perfeccionar su mapeo de campos y plantillas antes de comprometerse completamente.

¿Listo para Probar TaskNotes?

Descargue TaskForge y comience a utilizar el formato TaskNotes para sus flujos de trabajo de gestión detallada de tareas en Obsidian. Aprende sobre todas las capacidades de TaskNotes en nuestra página de funciones , y consulta las últimas mejoras de TaskNotes para actualizaciones recientes.

Azhar Dewji
Azhar Dewji · · Updated July 8, 2026

Ingeniero de software con más de 10 años de experiencia desarrollando aplicaciones móviles y de escritorio en Swift, Kotlin y Flutter. Desarrollador independiente afincado en Toronto, Canadá. Creador de TaskForge. Más información