obsidian-markdown

## Visión general de la skill obsidian-markdown

### Qué hace la skill obsidian-markdown
La skill `obsidian-markdown` ayuda a un agente a escribir y editar Obsidian Flavored Markdown válido en lugar de Markdown genérico. Está pensada para notas, páginas de bases de conocimiento y documentación que dependen de sintaxis específica de Obsidian, como `[[wikilinks]]`, `![[embeds]]`, callouts, etiquetas, propiedades de frontmatter, checklists y fórmulas matemáticas.

### Quién debería usar obsidian-markdown
Esta skill encaja mejor con quienes crean o mantienen un vault de Obsidian, una wiki de equipo, un cuaderno de investigación o un conjunto de documentación interna donde la estructura de las notas importa tanto como el texto. Si tu trabajo real consiste en “convertir notas en bruto en páginas útiles de Obsidian” o “mantener limpia la sintaxis de las notas en toda una base de conocimiento”, `obsidian-markdown` es una opción más adecuada que un prompt de escritura genérico.

### Por qué es diferente de un prompt normal de Markdown
Un prompt normal puede generar Markdown legible, pero aun así pasar por alto convenciones de Obsidian, sobre todo en wikilinks, embeds, callouts y metadatos. La `obsidian-markdown skill` orienta el modelo hacia una salida compatible con Obsidian, lo que reduce la limpieza posterior y facilita generar notas que puedas incorporar a un vault con menos correcciones manuales.

## Cómo usar la skill obsidian-markdown

### Contexto de instalación y qué leer primero
Esta skill se encuentra en `EN/.agents/skills/obsidian-markdown` dentro de `MarsWang42/OrbitOS`, y el archivo clave es `SKILL.md`. En el árbol proporcionado no hay scripts auxiliares, reglas ni referencias adicionales, así que la mayor parte de la guía útil sale de ese único archivo. Lee primero `SKILL.md` si quieres confirmar la sintaxis admitida y revisar ejemplos antes de aplicar los pasos de `obsidian-markdown install` en tu propio flujo de trabajo.

### Qué tipo de entrada hace que obsidian-markdown funcione bien
El `obsidian-markdown usage` da mejores resultados cuando proporcionas:
- el tipo de nota: nota de reunión, página conceptual, daily note, MOC, nota de referencia
- las funciones de Obsidian que necesitas: `[[links]]`, callouts, YAML frontmatter, tags, embeds
- las convenciones de tu vault: estilo de encabezados, nombres de propiedades, formato de nombres de archivo, reglas de tags
- el material de origen: viñetas en bruto, transcripción, esquema o una nota existente para depurar

Una solicitud débil sería: “write this in Obsidian format.”  
Una solicitud sólida sería: “Convert these raw research bullets into an Obsidian note with YAML frontmatter, `[[wikilinks]]` to related concepts, one `> [!summary]` callout, and action items as task checkboxes.”

### Cómo convertir un objetivo impreciso en un prompt útil
Para `obsidian-markdown for Knowledge Base Writing`, pide tanto estructura como sintaxis. Un patrón de prompt práctico es:

- objetivo: para qué sirve la nota
- audiencia: solo para ti, para un equipo o para documentación pública
- reglas del vault: nombres, tags, aliases, campos de estado
- restricciones de salida: un solo archivo, sin texto explicativo, solo Obsidian Markdown válido

Ejemplo:  
“Create an Obsidian concept note from these bullets. Use YAML frontmatter with `tags`, `aliases`, and `status`. Add `[[related notes]]`, keep headings shallow, and include a `> [!note]` callout for definitions. Output only the final Markdown.”

### Flujo de trabajo recomendado y consejos prácticos
Usa prompts con enfoque de `obsidian-markdown guide` en dos pasadas:
1. Genera el esqueleto de la nota: frontmatter, encabezados, enlaces y callouts.
2. Refina la calidad del contenido: ajusta resúmenes, corrige destinos de enlaces y normaliza tags.

Esta skill parece estar más centrada en la sintaxis que en la automatización del flujo, así que conviene verificar:
- que las claves del frontmatter coincidan con las convenciones de tu vault
- que los wikilinks apunten a títulos reales de notas
- que los embeds usen el nombre exacto del archivo de destino
- que los tipos de callout sean compatibles con el tema de tu vault

Si estás migrando Markdown existente, pídele al modelo que conserve el contenido y convierta solo la sintaxis. Eso reduce el riesgo de reescrituras accidentales.

## Preguntas frecuentes sobre la skill obsidian-markdown

### ¿Vale la pena usar obsidian-markdown en lugar de un prompt normal?
Sí, si la fidelidad de la sintaxis importa. El principal valor de `obsidian-markdown` no es mejorar el texto por sí solo, sino reducir errores en el formato específico de Obsidian. Si solo necesitas Markdown plano para GitHub o para un sitio estático, puede que esta skill no sea necesaria.

### ¿Es buena opción para principiantes que usan Obsidian?
Sí, sobre todo si sabes qué tipo de nota quieres pero no la sintaxis exacta. Los ejemplos de `SKILL.md` cubren el formato básico y las construcciones específicas de Obsidian, así que la skill puede ayudar a quienes empiezan a crear notas válidas más rápido. Aun así, necesitas conocer las convenciones de nombres y metadatos de tu propio vault.

### ¿Cuáles son los límites de la skill obsidian-markdown?
Esta skill está enfocada en crear y editar Obsidian Flavored Markdown. No es una herramienta de gestión de vaults, un validador de enlaces, un configurador de plugins ni una canalización de publicación. Ayuda a generar texto de notas correcto, pero no sabe si las notas de destino, los tags o los esquemas de propiedades ya existen, a menos que se los proporciones.

## Cómo mejorar la skill obsidian-markdown

### Dale a obsidian-markdown instrucciones más específicas para tu vault
La mejora de calidad más rápida llega cuando añades tus convenciones reales. Dile al modelo:
- cuáles son tus campos preferidos de frontmatter
- qué jerarquía de tags está permitida
- si debe usar `[[wikilinks]]` o enlaces Markdown
- qué tipos de callout utilizas de verdad
- cuáles son tus reglas de nombres de archivo o títulos

Sin esto, `obsidian-markdown` puede generar una salida técnicamente válida que, aun así, no encaje con tu vault.

### Evita los fallos de salida más comunes
Los problemas más habituales son enlaces inventados, propiedades inconsistentes, notas excesivamente estructuradas y resúmenes genéricos. Para evitarlos, proporciona una lista breve de “haz esto y no hagas esto”, por ejemplo:
- usa solo estos nombres de nota existentes
- no crees tags fuera de este conjunto
- mantente en un máximo de tres niveles de encabezados
- conserva la redacción original en las notas de investigación citadas

### Itera después del primer borrador con obsidian-markdown
El mejor `obsidian-markdown usage` es iterativo. Después del primer borrador, pide correcciones concretas en lugar de reescrituras completas:
- “Normalize frontmatter keys to my schema.”
- “Replace placeholder wikilinks with plain text where targets are unknown.”
- “Turn this long section into one summary callout and three bullet groups.”
- “Keep content unchanged, only convert to Obsidian syntax.”

Así mantienes la nota estable mientras mejoras la calidad del formato.

### Cuándo no usar obsidian-markdown
Omite la `obsidian-markdown skill` si la salida va a terminar en un destino que no sea Obsidian o si necesitas automatización con conocimiento del repositorio en lugar de ayuda de formato. La evidencia actual del repositorio apunta a una skill documental centrada en sintaxis, no a una cadena de herramientas más completa con scripts o validadores auxiliares. Úsala cuando tu cuello de botella sea la calidad del formato de las notas, no la integración con otros sistemas.