CommunitySchreiben & Editierengithub.com

pinosong/md-to-x-article-skill

Konvertiere Markdown-Langtext in einen polierten X-Article-Entwurf. Verwende dies, wenn ein Nutzer darum bittet, Markdown für X-Articles zu konvertieren, anzupassen, zu formatieren oder zu optimieren, einschließlich der Erstellung einer kopierbereiten Rich-Text-HTML-Version und einer bearbeiteten Markdown-Version.

Was ist md-to-x-article-skill?

Dieses Skill transformiert Markdown-Dokumente in veröffentlichungsreife X-Article-Entwürfe. Es ist ideal für Entwickler, Autoren und Content-Ersteller, die ihre Artikel für die X-Plattform optimieren möchten, wobei die Bedeutung des Originals erhalten bleibt und die mobile Lesbarkeit verbessert wird. Der Skill unterstützt die Ausgabe in zwei Formaten: eine bereinigte Markdown-Datei (`x-article-ready.md`) zur Überprüfung und eine HTML-Datei (`x-article-ready.html`) mit semantischen Elementen und einfachem CSS, die direkt in den X-Article-Editor kopiert werden kann. Er beachtet strikte Regeln für die Verarbeitung von Rich Media wie Bilder, Videos, GIFs und eingebettete X-Beiträge, indem er Einfügemarkierungen setzt und den Nutzer anweist, Medien nativ hochzuladen. Der Skill konvertiert Tabellen in Aufzählungspunkte, entfernt Platzhalter, bewahrt Zitate und überprüft die Ausgabe anhand einer Validierungs-Checkliste, um die Qualität sicherzustellen. Praktische Erkenntnisse aus einem Test mit DeepSeek (Oktober 2026) bestätigen, dass Markdown nicht direkt in den X-Editor eingefügt werden sollte, Bilder in der HTML-Vorschau base64-kodiert sein müssen und ein Premium-Abonnement für die Veröffentlichung erforderlich ist.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add pinosong/md-to-x-article-skill

Installed? Explore more Schreiben & Editieren skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Vorschau

Aus dem Skill-README

alt

Dokumentation

Markdown in X-Article konvertieren

Konvertiere das bereitgestellte Markdown in einen X-Article-Entwurf, der genau, auf mobilen Geräten lesbar und einfach in den X-Article-Editor einzufügen ist.

Kernregeln

  • Bewahre die Bedeutung des Autors, faktische Behauptungen, Zahlen, Links und die Gesamtposition.
  • Verbessere Struktur und Präsentation, ohne substanzielle Inhalte stillschweigend umzuschreiben.
  • Verwende eine klare, professionelle Sprache. Vermeide werbliche Übertreibungen und unnötigen Jargon.
  • Gib nicht vor, dass X einen direkten Markdown-Import unterstützt. Behandle HTML als eine kopierbereite Rich-Text-Quelle, nicht als Upload-Format.
  • X-Articles können Bilder, Videos, GIFs, eingebettete X-Beiträge und Links enthalten. Bewahre jedes sinnvolle Medienelement und seine vorgesehene Position.
  • Gib nicht vor, dass das Kopieren von HTML Medien in X hochlädt oder einbettet. Weise den Nutzer an, Medien nativ im X-Article-Editor hinzuzufügen.
  • Bevorzuge kurze Absätze, klare Überschriften, Listen, Fettschrift, Zitate und Links.
  • Verwende keine Markdown-Tabellen im endgültigen Veröffentlichungsentwurf. Konvertiere jede Tabellenzeile in einen prägnanten Aufzählungspunkt mit einer fetten Bezeichnung.
  • Entferne offensichtliche Platzhalter, leere Abschnitte, wiederholte Trennzeichen und Entwurfsnotizen.
  • Markiere unsichere Fakten oder defekte Links, anstatt Korrekturen zu erfinden.

Arbeitsablauf

  1. Lies die gesamte Quelle vor der Bearbeitung.

  2. Identifiziere den Titel, die Einleitung, die Abschnittshierarchie, Tabellen, Links, Platzhalter, den Schluss und alle Rich Media.

  3. Erstelle ein Medieninventar in Quellreihenfolge:

    • Bilder und Screenshots
    • Diagramme und Schaubilder
    • Video- und GIF-Dateien oder -Links
    • X-Beitrags-URLs, die zum Einbetten vorgesehen sind
    • Bildunterschriften, Credits, Quellenlinks und Alternativtext
  4. Erstelle einen spezifischen Titel, der das Thema und den Wert des Artikels genau kommuniziert.

  5. Füge eine kurze Einleitung hinzu oder verfeinere sie, die erklärt, warum das Thema wichtig ist. Füge keine unbelegten Behauptungen hinzu.

  6. Normalisiere die Hierarchie:

    • Verwende einen Artikel-Titel.
    • Verwende Abschnittsüberschriften für Hauptideen.
    • Verwende Unterüberschriften nur, wo sie die Navigation verbessern.
    • Korrigiere falsche oder inkonsistente Nummerierungen.
  7. Verbessere die mobile Lesbarkeit:

    • Behalte eine Hauptidee pro Absatz bei.
    • Teile dichte Passagen auf.
    • Verwende Aufzählungs- oder nummerierte Listen für parallele Elemente und Abläufe.
    • Fette nur die wichtigsten Phrasen.
  8. Konvertiere Tabellen mit diesem Muster in Listen:

    - **Bezeichnung**: Erklärung

  9. Verarbeite Rich Media gemäß den folgenden Regeln.

  10. Bewahre Zitate als Blockzitate und gültige Quellenlinks.

  11. Stärke den Schluss mit einer prägnanten Zusammenfassung. Entferne leere Empfehlungs- oder Ressourcenabschnitte.

  12. Führe die Validierungs-Checkliste vor der Auslieferung durch.

Rich-Media-Regeln

Bilder, Screenshots, Diagramme und Schaubilder

  • Bewahre jedes sinnvolle Bild beim nächstgelegenen relevanten Absatz.
  • Bewahre nützlichen Alternativtext. Verbessere vagen Alternativtext wie Bild nur, wenn der Bildinhalt bekannt ist.
  • Bewahre Bildunterschriften, Credits und Quellenlinks getrennt vom Alternativtext.
  • Überprüfe, ob lokale Bilddateien vorhanden sind, wenn Dateisystemzugriff verfügbar ist.
  • Behalte Remote-Bild-URLs als Referenz, verlasse dich jedoch nicht auf Hotlinked-Bilder für die endgültige Veröffentlichung.
  • Rendere in der HTML-Vorschau zugängliche Bilder mit img, alt und optionalem figcaption.
  • Bewahre in der Markdown-Ausgabe die standardmäßige Bildsyntax.
  • Empfehle ein starkes, relevantes Header-Bild, wenn die Quelle einen geeigneten Kandidaten hat. Erfinde oder generiere keines, es sei denn, es wird angefordert.

Videos und GIFs

  • Bewahre die ursprüngliche URL oder Dateireferenz und ihre vorgesehene Position.

  • Füge einen klaren Einfügemarkierer in beide Ausgaben ein, z. B.:

    [Video im X-Editor einfügen: Produktdemonstration — Quelle: ./demo.mp4]

  • Konvertiere ein Video oder GIF nicht in ein automatisch abspielendes HTML-Element.

  • Empfehle den nativen Upload im X-Article-Editor.

X-Beiträge

  • Erkenne x.com- und twitter.com-Status-URLs.
  • Bewahre die URL und markiere sie für die native Beitragseinbettung im X-Article-Editor.
  • Ersetze einen X-Beitrag nicht durch einen nicht unterstützten Iframe oder einen kopierten Screenshot, es sei denn, der Nutzer fordert es an.

Fehlende oder nicht zugängliche Medien

  • Entferne fehlende Medien niemals stillschweigend.
  • Behalte einen Einfügemarkierer bei, der den ursprünglichen Pfad oder die URL enthält.
  • Melde fehlende, nicht zugängliche oder nicht unterstützte Elemente in der Lieferzusammenfassung.

Mediendichte

  • Verwende Medien zum Erklären, Demonstrieren oder als Beleg.
  • Vermeide es, mehrere dekorative Bilder ohne klaren Zweck zusammenzustellen.
  • Halte Bildunterschriften prägnant und stelle sicher, dass jedes Bild im Kontext verständlich ist.

Erforderliche Ausgaben

Sofern der Nutzer kein anderes Format anfordert, erstelle beide Dateien im aktuellen Arbeitsbereich:

  • x-article-ready.md: bearbeitetes, lesbares Markdown für Überprüfung und zukünftige Überarbeitungen.
  • x-article-ready.html: eine saubere Rich-Text-Seite, die der Nutzer in einem Browser öffnen und in den X-Article-Editor kopieren kann.

Die HTML-Version muss:

  • Semantische Elemente wie article, h1, h2, h3, p, strong, em, blockquote, ul, ol, li und a verwenden.
  • Für Bilder, wo anwendbar, figure, img und figcaption verwenden.
  • UTF-8- und Viewport-Metadaten für responsive Darstellung enthalten.
  • Einfaches Inline-CSS für eine komfortable Browseransicht verwenden.
  • JavaScript, externe Abhängigkeiten, Tracking und dekorative Elemente vermeiden, die das Kopieren nicht überstehen.
  • Auf Desktop und Mobilgeräten sauber dargestellt werden.
  • Sichtbare Einfügemarkierungen für Videos, GIFs, fehlende Medien und native X-Beitragseinbettungen zeigen.

Wenn die Umgebung keine Dateien erstellen kann, gib den polierten Entwurf direkt zurück und erkläre die Einschränkung kurz.

Validierungs-Checkliste

Vor der Auslieferung überprüfen:

  • Der Titel erscheint einmal.
  • Die Überschriftsebenen sind konsistent.
  • Es sind keine Platzhalter oder leeren Abschnitte mehr vorhanden.
  • Es sind keine Markdown-Tabellen oder Trennzeichen-Zeilen mehr vorhanden.
  • Listen sind vollständig und korrekt geordnet.
  • Fett- und Kursivmarkierungen sind ausgewogen.
  • Links sind erhalten und nicht fehlerhaft.
  • Alle Rich Media sind im Medieninventar enthalten und bleiben an der richtigen Position im Artikel.
  • Alternativtext, Bildunterschriften, Credits und Quellenlinks von Bildern sind, wo verfügbar, erhalten.
  • Lokale Medienpfade existieren, oder fehlende Elemente sind klar gemeldet.
  • Einfügemarkierungen für Video, GIF und X-Beitrag sind vorhanden, wo native Editoraktionen erforderlich sind.
  • Zitate sind deutlich gekennzeichnet.
  • Keine substanzielle Behauptung, Zahl oder Schlussfolgerung wurde versehentlich geändert.
  • Der Artikel endet bewusst und nicht in einem leeren Abschnitt.
  • Das HTML öffnet sich erfolgreich und enthält denselben Artikelinhalt wie die Markdown-Version.

Lieferung

Gib kurz an:

  • Welche Dateien erstellt wurden.
  • Die wichtigsten strukturellen Änderungen.
  • Dass die HTML-Version in einem Browser geöffnet und in den X-Article-Editor kopiert werden sollte.
  • Welche Bilder, Videos, GIFs und X-Beiträge nativ in X hochgeladen oder eingebettet werden müssen.
  • Etwaige faktische, Link- oder Formatierungsprobleme, die noch eine menschliche Überprüfung erfordern.

Lokaler Testhinweis (2026-10-17, DeepSeek 1017 Artikel-zu-X-Test)

  • Markdown nicht direkt in den X-Editor einfügen: Test ergab, dass ![alt](Pfad) als Text angezeigt wird, X es nicht parst. Richtiger Ablauf: Öffne x-article-ready.html → alles auswählen und kopieren → in den X-Article-Editor einfügen; Titel/Fettschrift/Listen werden als Rich-Text übertragen.
  • Bilder in der HTML-Vorschau müssen base64-kodiert sein: Relative Pfade führen zu defekten Bildern, wenn der Nutzer die Datei einzeln öffnet. Videos nicht einbetten; Einfügemarkierungen mit gestrichelter Linie setzen, die der Nutzer manuell im Editor hochlädt.
  • X-Artikel-Cover 1600×900 (16:9), die Feed-Vorschau schneidet enger bei, wichtiger Inhalt zentriert; unterscheidet sich im Layout von WeChat-Cover (900×500, Abonnementlisten-Miniaturansicht), also unterschiedlich designen. Chinesische Titel wie gehabt mit PIL präzise setzen.
  • Veröffentlichung erfordert Premium oder höher; X-Articles unterstützen das Einbetten mehrerer Videos an beliebigen Stellen im Textkörper.

Verwandte Skills