pinosong/md-to-x-article-skill

Converter Markdown para Artigo do X

Converta o Markdown fornecido em um rascunho de Artigo do X que seja preciso, legível em dispositivos móveis e fácil de colar no editor de Artigos do X.

Regras Principais

• Preserve o significado do autor, alegações factuais, números, links e posição geral.
• Melhore a estrutura e a apresentação sem reescrever silenciosamente o conteúdo substantivo.
• Use linguagem simples e profissional. Evite exageros promocionais e jargões desnecessários.
• Não afirme que o X suporta importação direta de Markdown. Trate o HTML como uma fonte de rich-text pronta para cópia, não como um formato de upload.
• Artigos do X podem conter imagens, vídeos, GIFs, posts do X incorporados e links. Preserve cada item de mídia significativo e sua posição pretendida.
• Não insinue que copiar HTML fará upload ou incorporará mídia no X. Instrua o usuário a adicionar mídia nativamente no editor de Artigos do X.
• Prefira parágrafos curtos, cabeçalhos claros, listas, ênfase em negrito, citações e links.
• Não use tabelas Markdown no rascunho final de publicação. Converta cada linha de tabela em um bullet conciso com um rótulo em negrito.
• Remova placeholders óbvios, seções vazias, separadores repetidos e anotações de rascunho.
• Sinalize fatos incertos ou links quebrados em vez de inventar correções.

Fluxo de Trabalho

1. Leia a fonte completa antes de editar.

2. Identifique o título, abertura, hierarquia de seções, tabelas, links, placeholders, final e toda a mídia rica.

3. Crie um inventário de mídia na ordem de origem:

   • Imagens e capturas de tela
   • Gráficos e diagramas
   • Arquivos de vídeo e GIF ou links
   • URLs de posts do X destinados a incorporação
   • Legendas, créditos, links de origem e texto alternativo

4. Crie um título específico que comunique com precisão o assunto e o valor do artigo.

5. Adicione ou refine uma breve abertura que explique por que o assunto é importante. Não adicione alegações não fundamentadas.

6. Normalize a hierarquia:

   • Use um título de artigo.
   • Use cabeçalhos de seção para as ideias principais.
   • Use subtítulos apenas onde eles melhoram a navegação.
   • Corrija numeração incorreta ou inconsistente.

7. Melhore a legibilidade em dispositivos móveis:

   • Mantenha uma ideia principal por parágrafo.
   • Divida passagens densas.
   • Use bullets ou listas numeradas para itens paralelos e procedimentos.
   • Coloque em negrito apenas as frases mais importantes.

8. Converta tabelas em listas usando este padrão:

   - **Rótulo**: explicação

9. Processe mídia rica usando as regras abaixo.

10. Preserve citações como blockquotes e preserve links de origem válidos.

11. Fortaleça o final com um resumo conciso. Remova seções vazias de recomendações ou recursos.

12. Execute a lista de verificação de validação antes da entrega.

Regras de Mídia Rica

Imagens, Capturas de Tela, Gráficos e Diagramas

• Preserve cada imagem significativa no parágrafo relevante mais próximo.
• Preserve o texto alternativo útil. Melhore texto alternativo vago, como imagem, apenas quando o conteúdo da imagem for conhecido.
• Preserve legendas, créditos e links de origem separadamente do texto alternativo.
• Verifique se os arquivos de imagem locais existem quando o acesso ao sistema de arquivos estiver disponível.
• Mantenha URLs de imagem remotas para referência, mas não confie em imagens vinculadas por hotlink para a publicação final.
• Na pré-visualização HTML, renderize imagens acessíveis com img, alt e figcaption opcional.
• Na saída Markdown, preserve a sintaxe de imagem padrão.
• Recomende uma imagem de cabeçalho forte e relevante quando a fonte tiver um candidato adequado. Não invente ou gere uma a menos que solicitado.

Vídeos e GIFs

• Preserve o URL original ou a referência de arquivo e sua posição pretendida.

• Adicione um marcador de inserção claro em ambas as saídas, como:

  [Inserir vídeo no editor do X: demonstração do produto — fonte: ./demo.mp4]

• Não converta um vídeo ou GIF em um embed HTML com reprodução automática.

• Recomende upload nativo no editor de Artigos do X.

Posts do X

• Detecte URLs de status x.com e twitter.com.
• Preserve o URL e marque-o para incorporação nativa de post no editor de Artigos do X.
• Não substitua um post do X por um iframe não suportado ou captura de tela copiada, a menos que o usuário solicite.

Mídia Ausente ou Inacessível

• Nunca remova silenciosamente mídia ausente.
• Mantenha um marcador de inserção que inclua o caminho ou URL original.
• Relate itens ausentes, inacessíveis ou não suportados no resumo de entrega.

Densidade de Mídia

• Use mídia para explicar, demonstrar ou fornecer evidências.
• Evite colocar várias imagens decorativas juntas sem um propósito claro.
• Mantenha legendas concisas e garanta que cada visual seja compreensível no contexto.

Saídas Obrigatórias

A menos que o usuário solicite outro formato, crie ambos os arquivos no espaço de trabalho atual:

• x-article-ready.md: Markdown editado e legível para revisão e revisões futuras.
• x-article-ready.html: uma página de rich-text limpa que o usuário pode abrir em um navegador e copiar para o editor de Artigos do X.

A versão HTML deve:

• Usar elementos semânticos como article, h1, h2, h3, p, strong, em, blockquote, ul, ol, li e a.
• Usar figure, img e figcaption para imagens quando aplicável.
• Incluir metadados UTF-8 e viewport responsivo.
• Usar CSS inline simples para uma revisão confortável no navegador.
• Evitar JavaScript, dependências externas, rastreamento e elementos decorativos que não sobreviverão à cópia.
• Exibir de forma limpa em desktop e dispositivos móveis.
• Mostrar marcadores de inserção visíveis para vídeo, GIF, mídia ausente e incorporações nativas de posts do X.

Se o ambiente não puder criar arquivos, retorne o rascunho polido diretamente e explique a limitação brevemente.

Lista de Verificação de Validação

Antes de entregar, verifique:

• O título aparece uma vez.
• Os níveis de cabeçalho são consistentes.
• Nenhum placeholder ou seção vazia permanece.
• Nenhuma tabela Markdown ou linhas apenas com separador permanecem.
• As listas estão completas e corretamente ordenadas.
• Marcadores de negrito e itálico estão equilibrados.
• Os links são preservados e não malformados.
• Toda a mídia rica aparece no inventário de mídia e permanece na posição correta do artigo.
• O texto alternativo da imagem, legendas, créditos e links de origem são preservados quando disponíveis.
• Caminhos de mídia local existem, ou itens ausentes são claramente relatados.
• Marcadores de inserção de vídeo, GIF e post do X estão presentes onde ações nativas do editor são necessárias.
• As citações são claramente distinguidas.
• Nenhuma alegação substantiva, número ou conclusão foi alterada acidentalmente.
• O artigo termina deliberadamente em vez de desaparecer em uma seção vazia.
• O HTML abre com sucesso e contém o mesmo conteúdo do artigo que a versão Markdown.

Entrega

Declare brevemente:

• Quais arquivos foram criados.
• As principais mudanças estruturais feitas.
• Que a versão HTML deve ser aberta em um navegador e copiada para o editor de Artigos do X.
• Quais imagens, vídeos, GIFs e posts do X devem ser carregados ou incorporados nativamente no X.
• Quaisquer problemas factuais, de link ou de formatação que ainda exijam revisão 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 支持正文任意位置内嵌多个视频。