# Convert X Posts to Markdown

Saving X posts and articles manually loses structure, metadata, and media references. This skill retrieves selected X content and organizes it as Markdown with YAML front matter and optional local media.

## Install

```bash
npx skillstore add jimliu/baoyu-danger-x-to-markdown
```

## Metadata

- Status: approved
- Slug: jimliu-baoyu-danger-x-to-markdown
- Version: 1.117.3
- Author version: 1.117.3
- Skillstore revision: r2
- Version status: valid
- Tree hash: 515acf06b8368f217d224e44b68c5bcd1c03bcb591751f1f73d429f79da5679c
- Author: jimliu
- GitHub username: jimliu
- License: MIT
- Repository: https://github.com/jimliu/baoyu-skills/tree/main/skills/baoyu-danger-x-to-markdown/
- Ref: 1c2ebded2116f8124f45dba86a2e567f56e64d8e
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: confirmation\_required
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: filesystem, network, external\_commands, env\_access, scripts
- Quality score: 38
- Quality tier: warning
- Public page: https://skillstore.pages.dev/skills/jimliu-baoyu-danger-x-to-markdown
- Manifest: https://skillstore.pages.dev/api/skills/jimliu-baoyu-danger-x-to-markdown/manifest

## Capabilities

- Convert X posts and threads into Markdown with YAML front matter.
- Extract X Articles and preserve article text, links, tweets, and media references.
- Resolve authenticated X content through environment cookies or a Chrome login session.
- Save output using predictable user-selected directories and filenames.
- Download supported images and videos into local folders when the user enables media localization.

## Use Cases

- Archive Research Threads: Convert a research thread into a searchable Markdown note with its source URL, author metadata, and linked media.
- Save Articles for Writing: Extract an X Article into an editable Markdown draft for citation, review, and later synthesis.
- Build a Personal Knowledge Base: Store selected posts in a predictable folder structure so they can be indexed by local notes and documentation tools.

## Prompt Templates

### Convert One Post

```
Convert this X post to Markdown with YAML front matter: [paste the X URL]. Keep the original source link.
```

### Archive a Thread

```
Convert this X thread to Markdown: [paste the X URL]. Preserve the thread order, author details, source links, and media references.
```

### Extract an Article

```
Convert this X Article to a clean Markdown document: [paste the X Article URL]. Include YAML front matter, headings, links, embedded posts, and media references.
```

### Create a Local Archive

```
Convert these X URLs into separate Markdown files: [paste URLs]. Use consistent metadata, organize files by author and post ID, and download media only after asking for confirmation.
```

## Limitations

- The skill depends on a reverse-engineered X API that can change without notice.
- Authenticated content requires valid X cookies and may trigger account restrictions.
- Media localization can contact URLs embedded in content and should use trusted inputs.
- Output formatting depends on the source content and may not preserve every X feature.

## Best Practices

- Review the consent notice and use a dedicated X session for archival work.
- Store cookies securely and enable media downloads only for trusted content.
- Keep the generated source URL and metadata so archived notes remain traceable.

## Anti Patterns

- Do not provide cookies from an account that should not be accessed.
- Do not use media localization on untrusted content without network restrictions.
- Do not treat the generated Markdown as a complete backup of every X feature.

## Security Audit

- Audited at: 2026-08-07T10:35:19.977\+00:00
- Summary: Most static alerts are false positives caused by ordinary JavaScript template literals, regular expression methods, expected X endpoints, configuration reads, and Markdown file handling. The audit confirms a shell-command injection risk in the WSL path resolver, and it flags deliberate handling of X authentication cookies plus host-controlled media downloads as risks requiring user trust and tighter controls.

## Stats

- Views: 234
- Downloads: 10
- Favorites: 0
- Popularity score: 0