pinosong/md-to-x-article-skill

Convertir Markdown a X Article

Convierte el Markdown proporcionado en un borrador de X Article preciso, legible en dispositivos móviles y fácil de pegar en el editor de X Article.

Reglas Fundamentales

• Conserva el significado del autor, las afirmaciones factuales, números, enlaces y la posición general.
• Mejora la estructura y presentación sin reescribir contenido sustantivo de forma silenciosa.
• Utiliza un lenguaje profesional y sencillo. Evita la exageración promocional y la jerga innecesaria.
• No afirmes que X admite importación directa de Markdown. Trata el HTML como una fuente de texto enriquecido para copiar, no como un formato de carga.
• X Articles puede contener imágenes, video, GIFs, publicaciones de X incrustadas y enlaces. Conserva cada elemento multimedia significativo y su posición prevista.
• No des a entender que copiar el HTML cargará o incrustará medios en X. Indica al usuario que agregue los medios de forma nativa en el editor de X Article.
• Prefiere párrafos cortos, encabezados claros, listas, énfasis en negrita, citas y enlaces.
• No uses tablas de Markdown en el borrador final de publicación. Convierte cada fila de tabla en un punto conciso con una etiqueta en negrita.
• Elimina marcadores de posición evidentes, secciones vacías, separadores repetidos y notas de borrador.
• Señala hechos inciertos o enlaces rotos en lugar de inventar correcciones.

Flujo de Trabajo

1. Lee la fuente completa antes de editar.

2. Identifica el título, la apertura, la jerarquía de secciones, tablas, enlaces, marcadores de posición, el final y todos los medios enriquecidos.

3. Crea un inventario de medios en el orden de la fuente:

   • Imágenes y capturas de pantalla
   • Gráficos y diagramas
   • Archivos o enlaces de video y GIF
   • URLs de publicaciones de X destinadas a ser incrustadas
   • Leyendas, créditos, enlaces de origen y texto alternativo

4. Crea un título específico que comunique con precisión el tema y el valor del artículo.

5. Añade o refina una apertura breve que explique por qué el tema es importante. No añadas afirmaciones sin respaldo.

6. Normaliza la jerarquía:

   • Usa un título de artículo.
   • Usa encabezados de sección para las ideas principales.
   • Usa subtítulos solo cuando mejoren la navegación.
   • Corrige la numeración incorrecta o inconsistente.

7. Mejora la legibilidad móvil:

   • Mantén una idea principal por párrafo.
   • Divide pasajes densos.
   • Usa viñetas o listas numeradas para elementos paralelos y procedimientos.
   • Pon en negrita solo las frases más importantes.

8. Convierte tablas a listas usando este patrón:

   - **Etiqueta**: explicación

9. Procesa los medios enriquecidos usando las reglas siguientes.

10. Conserva las citas como blockquotes y conserva los enlaces de origen válidos.

11. Refuerza el final con un resumen conciso. Elimina secciones vacías de recomendaciones o recursos.

12. Realiza la lista de verificación de validación antes de la entrega.

Reglas para Medios Enriquecidos

Imágenes, Capturas de Pantalla, Gráficos y Diagramas

• Conserva cada imagen significativa en el párrafo relevante más cercano.
• Conserva el texto alternativo útil. Mejora el texto alternativo vago como imagen solo cuando se conozca el contenido de la imagen.
• Conserva las leyendas, créditos y enlaces de origen por separado del texto alternativo.
• Verifica que los archivos de imagen locales existan cuando haya acceso al sistema de archivos.
• Mantén las URLs de imágenes remotas como referencia, pero no dependas de imágenes enlazadas para la publicación final.
• En la vista previa HTML, renderiza imágenes accesibles con img, alt y figcaption opcional.
• En la salida Markdown, conserva la sintaxis estándar de imágenes.
• Recomienda una imagen de portada fuerte y relevante cuando la fuente tenga un candidato adecuado. No inventes ni generes una a menos que se solicite.

Video y GIFs

• Conserva la URL o referencia de archivo original y su posición prevista.

• Añade un marcador de inserción claro en ambas salidas, como:

  [Insertar video en el editor de X: demostración del producto — fuente: ./demo.mp4]

• No conviertas un video o GIF en un embed HTML de reproducción automática.

• Recomienda la carga nativa en el editor de X Article.

Publicaciones de X

• Detecta URLs de estado de x.com y twitter.com.
• Conserva la URL y márcala para su incrustación nativa en el editor de X Article.
• No reemplaces una publicación de X con un iframe no compatible o una captura de pantalla copiada a menos que el usuario lo solicite.

Medios Faltantes o Inaccesibles

• No elimines silenciosamente medios faltantes.
• Mantén un marcador de inserción que incluya la ruta o URL original.
• Informa sobre elementos faltantes, inaccesibles o no compatibles en el resumen de entrega.

Densidad de Medios

• Usa medios para explicar, demostrar o proporcionar evidencia.
• Evita colocar varias imágenes decorativas juntas sin un propósito claro.
• Mantén las leyendas concisas y asegúrate de que cada elemento visual sea comprensible en contexto.

Salidas Requeridas

A menos que el usuario solicite otro formato, crea ambos archivos en el espacio de trabajo actual:

• x-article-ready.md: Markdown editado y legible para revisión y revisiones futuras.
• x-article-ready.html: una página de texto enriquecido limpia que el usuario pueda abrir en un navegador y copiar en el editor de X Article.

La versión HTML debe:

• Usar elementos semánticos como article, h1, h2, h3, p, strong, em, blockquote, ul, ol, li y a.
• Usar figure, img y figcaption para imágenes cuando corresponda.
• Incluir metadatos UTF-8 y viewport adaptable.
• Usar CSS inline simple para una revisión cómoda en el navegador.
• Evitar JavaScript, dependencias externas, seguimiento y elementos decorativos que no sobrevivan a la copia.
• Mostrarse de forma limpia en escritorio y móvil.
• Mostrar marcadores de inserción visibles para video, GIF, medios faltantes y publicaciones de X incrustadas de forma nativa.

Si el entorno no puede crear archivos, devuelve el borrador pulido directamente y explica la limitación brevemente.

Lista de Verificación de Validación

Antes de entregar, verifica:

• El título aparece una vez.
• Los niveles de encabezado son consistentes.
• No quedan marcadores de posición ni secciones vacías.
• No quedan tablas de Markdown ni líneas de solo separador.
• Las listas están completas y correctamente ordenadas.
• Los marcadores de negrita y cursiva están equilibrados.
• Los enlaces se conservan y no están mal formados.
• Todos los medios enriquecidos aparecen en el inventario de medios y permanecen en la posición correcta del artículo.
• El texto alternativo, leyendas, créditos y enlaces de origen de las imágenes se conservan cuando están disponibles.
• Las rutas de medios locales existen, o los elementos faltantes se informan claramente.
• Los marcadores de inserción de video, GIF y publicaciones de X están presentes donde se requieren acciones nativas del editor.
• Las citas están claramente distinguidas.
• Ninguna afirmación sustancial, número o conclusión se cambió accidentalmente.
• El artículo termina deliberadamente en lugar de desvanecerse en una sección vacía.
• El HTML se abre correctamente y contiene el mismo contenido del artículo que la versión Markdown.

Entrega

Indica brevemente:

• Qué archivos se crearon.
• Los principales cambios estructurales realizados.
• Que la versión HTML debe abrirse en un navegador y copiarse en el editor de X Article.
• Qué imágenes, videos, GIFs y publicaciones de X deben cargarse o incrustarse de forma nativa en X.
• Cualquier problema factual, de enlace o de formato que aún requiera revisión humana.

本地实测补充（2026-10-17，DeepSeek 1017 文章转 X 实测）

• 不要直接粘 Markdown 进 X 编辑器：实测 ![alt](路径) 原样显示为文本，X 不解析。正确流：打开 x-article-ready.html → 全选复制 → 粘进 X 文章编辑器，标题/加粗/列表以富文本带过去。
• HTML 预览里的图片必须 base64 内嵌：相对路径引用在用户单开文件时必裂图。视频不内嵌，留虚线插入标记，用户在编辑器手动上传。
• X 文章封面 1600×900（16:9），feed 预览裁得更紧，关键内容居中；跟微信封面（900×500，订阅列表缩略图）流量逻辑不同，要区分设计。中文标题照旧 PIL 精确排。
• 发布需要 Premium 及以上订阅；X Articles 支持正文任意位置内嵌多个视频。