jimliu/baoyu-format-markdown

¿Qué hace baoyu-format-markdown?

Da formato a texto plano o archivos markdown con metadatos (frontmatter), títulos, resúmenes, encabezados, negritas, listas y bloques de código. Úsala cuando el usuario solicite "formatear markdown", "embellecer artículo", "añadir formato" o mejorar el diseño del artículo. La salida se guarda como {nombre-del-archivo}-formatted.md.

Cómo funciona

1. La IA lee el contenido proporcionado (texto plano o markdown existente).
2. Analiza la estructura: detecta posibles títulos, párrafos, listas, código y elementos de metadatos.
3. Aplica formato markdown estandarizado:
   • Añade bloque de metadatos YAML (frontmatter) con campos como título, resumen y fecha (si es relevante).
   • Convierte líneas de texto plano en encabezados (#, ##, ###), negritas (**texto**), listas (- elemento) y bloques de código (`código` o bloques con triple backtick).
   • Asegura sangría y espaciado consistente.
4. Genera un nuevo archivo markdown con el nombre del original más el sufijo -formatted.md.

Plataformas soportadas

• Claude Code: Compatible mediante instrucciones de habilidad personalizadas.
• Cursor: Se integra como regla de formateo en el contexto del proyecto.
• Codex / GitHub Copilot: Se puede invocar mediante prompt específico.

Ejemplo de uso

Entrada (texto plano):

mi articulo
por juan

hola mundo esto es un ejemplo
- item 1
- item 2

Salida (markdown formateado):

---
título: "Mi Artículo"
autor: "Juan"
fecha: "2025-03-28"
resumen: "Un ejemplo de artículo formateado."
---

# Mi Artículo

**Autor:** Juan  
**Fecha:** 2025-03-28

Hola mundo, esto es un **ejemplo**.

- Item 1
- Item 2

Comandos útiles

• formatear markdown [archivo] – Aplica formato al archivo especificado.
• embellecer artículo [texto] – Da formato a un texto proporcionado directamente.
• mejorar diseño [archivo] – Reestructura el diseño del artículo.

Notas

• El archivo original nunca se modifica; siempre se crea una copia con el sufijo -formatted.md.
• Si el texto ya contiene markdown, se respetan los elementos existentes y solo se mejoran o completan según sea necesario.
• La habilidad es idempotente: aplicar formato repetidamente al mismo archivo produce el mismo resultado.

---

Habilidad creada por jimliu para mejorar la legibilidad y estructura de documentos markdown.