pinosong/md-to-x-article-skill

마크다운을 X Article로 변환

제공된 마크다운을 모바일에서 정확하게 읽히고 X Article 편집기에 쉽게 붙여넣을 수 있는 X Article 초안으로 변환합니다.

핵심 규칙

• 작성자의 의미, 사실적 주장, 숫자, 링크 및 전체 입장을 보존합니다.
• 실질적인 내용을 묵시적으로 다시 쓰지 않고 구조와 표현을 개선합니다.
• 평범하고 전문적인 언어를 사용합니다. 과장된 홍보와 불필요한 전문 용어를 피합니다.
• X가 마크다운 직접 가져오기를 지원한다고 주장하지 않습니다. HTML을 업로드 형식이 아닌 복사 가능한 리치 텍스트 소스로 취급합니다.
• X Article은 이미지, 비디오, GIF, 임베디드 X 게시물 및 링크를 포함할 수 있습니다. 모든 의미 있는 미디어 항목과 의도된 위치를 보존합니다.
• HTML을 복사하면 X에 미디어가 업로드되거나 임베드된다고 암시하지 않습니다. 사용자에게 X Article 편집기에서 기본적으로 미디어를 추가하라고 알립니다.
• 짧은 단락, 명확한 제목, 목록, 굵은 강조, 인용 및 링크를 선호합니다.
• 최종 게시 초안에서 마크다운 표를 사용하지 마십시오. 각 표 행을 굵은 레이블이 있는 간결한 글머리 기호로 변환합니다.
• 명백한 자리 표시자, 빈 섹션, 반복되는 구분선 및 초안 작성 노트를 제거합니다.
• 불확실한 사실이나 깨진 링크는 해결책을 만들어내지 말고 표시합니다.

워크플로우

1. 편집하기 전에 전체 소스를 읽습니다.

2. 제목, 도입부, 섹션 계층 구조, 표, 링크, 자리 표시자, 끝 부분 및 모든 리치 미디어를 식별합니다.

3. 소스 순서대로 미디어 인벤토리를 만듭니다.

   • 이미지 및 스크린샷
   • 차트 및 다이어그램
   • 비디오 및 GIF 파일 또는 링크
   • 임베딩을 위한 X 게시물 URL
   • 캡션, 크레딧, 소스 링크 및 대체 텍스트

4. 기사의 주제와 가치를 정확하게 전달하는 구체적인 제목을 만듭니다.

5. 주제가 왜 중요한지 설명하는 간결한 도입부를 추가하거나 개선합니다. 입증되지 않은 주장을 추가하지 마십시오.

6. 계층 구조를 정규화합니다.

   • 하나의 기사 제목을 사용합니다.
   • 주요 아이디어에는 섹션 제목을 사용합니다.
   • 탐색을 개선하는 경우에만 부제목을 사용합니다.
   • 잘못되었거나 일관성 없는 번호를 수정합니다.

7. 모바일 가독성을 개선합니다.

   • 단락당 하나의 주요 아이디어를 유지합니다.
   • 밀도가 높은 구절을 나눕니다.
   • 병렬 항목 및 절차에는 글머리 기호 또는 번호가 매겨진 목록을 사용합니다.
   • 가장 중요한 구문에만 굵게를 사용합니다.

8. 표를 다음 패턴을 사용하여 목록으로 변환합니다.

   - **레이블**: 설명

9. 아래 규칙을 사용하여 리치 미디어를 처리합니다.

10. 인용문을 블록 인용구로 보존하고 유효한 소스 링크를 보존합니다.

11. 간결한 요약으로 끝 부분을 강화합니다. 빈 권장 사항 또는 리소스 섹션을 제거합니다.

12. 전달 전에 유효성 검사 체크리스트를 수행합니다.

리치 미디어 규칙

이미지, 스크린샷, 차트 및 다이어그램

• 각 의미 있는 이미지를 가장 가까운 관련 단락에 보존합니다.
• 유용한 대체 텍스트를 보존합니다. 이미지 내용이 알려진 경우에만 '이미지'와 같은 모호한 대체 텍스트를 개선합니다.
• 캡션, 크레딧 및 소스 링크를 대체 텍스트와 별도로 보존합니다.
• 파일 시스템 액세스가 가능한 경우 로컬 이미지 파일이 존재하는지 확인합니다.
• 참조를 위해 원격 이미지 URL을 유지하지만 최종 게시를 위해 핫링크된 이미지에 의존하지 마십시오.
• HTML 미리보기에서 img, alt 및 선택적 figcaption으로 접근 가능한 이미지를 렌더링합니다.
• 마크다운 출력에서 표준 이미지 구문을 보존합니다.
• 소스에 적합한 후보가 있는 경우 하나의 강력하고 관련성 높은 헤더 이미지를 권장합니다. 요청하지 않는 한 이미지를 만들거나 생성하지 마십시오.

비디오 및 GIF

• 원본 URL 또는 파일 참조와 의도된 위치를 보존합니다.

• 두 출력 모두에 다음과 같은 명확한 삽입 표시를 추가합니다.

  [X 편집기에 비디오 삽입: 제품 데모 — 출처: ./demo.mp4]

• 비디오 또는 GIF를 자동 재생 HTML 임베드로 변환하지 마십시오.

• X Article 편집기에서 기본 업로드를 권장합니다.

X 게시물

• x.com 및 twitter.com 상태 URL을 감지합니다.
• URL을 보존하고 X Article 편집기에서 기본 게시물 임베딩을 위해 표시합니다.
• 사용자가 요청하지 않는 한 X 게시물을 지원되지 않는 iframe이나 복사된 스크린샷으로 대체하지 마십시오.

누락되었거나 접근 불가능한 미디어

• 누락된 미디어를 묵시적으로 제거하지 마십시오.
• 원래 경로 또는 URL을 포함하는 삽입 표시를 유지합니다.
• 전달 요약에 누락되었거나, 접근 불가능하거나, 지원되지 않는 항목을 보고합니다.

미디어 밀도

• 설명, 시연 또는 증거 제공을 위해 미디어를 사용합니다.
• 명확한 목적 없이 여러 장식 이미지를 함께 배치하지 마십시오.
• 캡션을 간결하게 유지하고 각 시각 자료가 맥락에서 이해 가능한지 확인합니다.

필수 출력

사용자가 다른 형식을 요청하지 않는 한 현재 작업 공간에 두 파일을 모두 만듭니다.

• x-article-ready.md: 검토 및 향후 수정을 위한 편집되고 읽기 쉬운 마크다운.
• x-article-ready.html: 사용자가 브라우저에서 열어 X Article 편집기에 복사할 수 있는 깔끔한 리치 텍스트 페이지.

HTML 버전은 다음을 충족해야 합니다.

• article, h1, h2, h3, p, strong, em, blockquote, ul, ol, li 및 a와 같은 의미 요소를 사용합니다.
• 해당되는 경우 이미지에 figure, img 및 figcaption을 사용합니다.
• UTF-8 및 반응형 뷰포트 메타데이터를 포함합니다.
• 편안한 브라우저 검토를 위해 간단한 인라인 CSS를 사용합니다.
• JavaScript, 외부 종속성, 추적 및 복사 후 유지되지 않는 장식 요소를 피합니다.
• 데스크톱과 모바일에서 깔끔하게 표시됩니다.
• 비디오, GIF, 누락된 미디어 및 기본 X 게시물 임베드를 위한 보이는 삽입 표시를 보여줍니다.

환경이 파일을 생성할 수 없는 경우, 초안을 직접 반환하고 제한 사항을 간략히 설명합니다.

유효성 검사 체크리스트

전달하기 전에 다음을 확인합니다.

• 제목이 한 번 나타납니다.
• 제목 수준이 일관됩니다.
• 자리 표시자나 빈 섹션이 남아 있지 않습니다.
• 마크다운 표나 구분선만 있는 행이 남아 있지 않습니다.
• 목록이 완전하고 올바르게 정렬되었습니다.
• 굵게 및 기울임꼴 표시가 균형을 이룹니다.
• 링크가 보존되었으며 손상되지 않았습니다.
• 모든 리치 미디어가 미디어 인벤토리에 나타나며 올바른 기사 위치에 유지됩니다.
• 이미지 대체 텍스트, 캡션, 크레딧 및 소스 링크가 사용 가능한 경우 보존됩니다.
• 로컬 미디어 경로가 존재하거나 누락된 항목이 명확하게 보고됩니다.
• 기본 편집기 작업이 필요한 곳에 비디오, GIF 및 X 게시물 삽입 표시가 있습니다.
• 인용문이 명확하게 구분됩니다.
• 실질적인 주장, 숫자 또는 결론이 실수로 변경되지 않았습니다.
• 기사가 빈 섹션으로 희미해지는 대신 의도적으로 끝납니다.
• HTML이 성공적으로 열리며 마크다운 버전과 동일한 기사 콘텐츠를 포함합니다.

전달

간략히 다음을 명시합니다.

• 어떤 파일이 생성되었는지.
• 주요 구조 변경 사항.
• HTML 버전을 브라우저에서 열어 X Article 편집기에 복사해야 한다는 점.
• X에 기본적으로 업로드하거나 임베드해야 하는 이미지, 비디오, GIF 및 X 게시물.
• 여전히 인간의 검토가 필요한 모든 사실, 링크 또는 서식 문제.

로컬 실측 보충 (2026-10-17, DeepSeek 1017 기사 → X 실측)

• X 편집기에 마크다운을 직접 붙여넣지 마십시오. 실측 결과 ![alt](경로)가 텍스트로 그대로 표시되며 X는 이를 구문 분석하지 않습니다. 올바른 흐름: x-article-ready.html을 열고 → 전체 선택하여 복사한 후 → X 기사 편집기에 붙여넣으면 제목/굵게/목록이 서식 있는 텍스트로 전달됩니다.
• HTML 미리보기의 이미지는 반드시 base64로 인라인 포함해야 합니다. 상대 경로 참조는 사용자가 단독으로 파일을 열 때 이미지가 깨집니다. 비디오는 인라인 포함하지 말고 점선 삽입 표시를 남겨 사용자가 편집기에서 수동으로 업로드하도록 합니다.
• X 기사 표지는 1600×900(16:9)이며, 피드 미리보기에서는 더 좁게 잘리므로 핵심 콘텐츠를 중앙에 배치해야 합니다. WeChat 표지(900×500, 구독 목록 썸네일)와 트래픽 로직이 다르므로 구분하여 설계해야 합니다. 한글 제목은 기존대로 PIL로 정확하게 배치합니다.
• 게시에는 Premium 이상 구독이 필요합니다. X Articles는 본문 내 임의 위치에 여러 비디오를 인라인 포함할 수 있습니다.