@geekjourneyx/md2x
v1.0.6
Published
Agent Native CLI for publishing Markdown to X Articles with DraftJS, media upload, and OAuth2 PKCE.
Readme
md2x
Agent Native Go CLI for turning Markdown into X Articles drafts.
Chinese · Quickstart · Install · Usage · Config · Markdown · Agent Guide
What It Does
md2x is an Agent Native CLI for Markdown-to-X Articles publishing workflows. It does four things:
inspectchecks Markdown readiness before you authenticate.renderproduces deterministic DraftJScontent_state.authmanages X OAuth2 PKCE login for user-context API access.draftcreates X Article drafts through the official X API.
V1 is draft-first. It creates drafts and does not publish by default, so terminal users and agents can stop at a reviewable state before anything goes live.
Quick Start
npm install -g @geekjourneyx/md2x
md2x inspect article.md --json
md2x render article.md --format draftjs --json
md2x config init --client-id YOUR_X_OAUTH2_CLIENT_ID
md2x auth login
md2x draft article.md --jsonFor legacy xurl token stores, md2x draft article.md --app md2x --json remains supported.
Why md2x Exists
X Articles are not plain Markdown. The API expects DraftJS content state, uploaded media IDs, and user-context authentication. md2x turns that into a small Agent Native CLI contract that is easy for humans to run and easy for agents to reason about.
The source file stays Markdown. The compiler path stays inspectable. The live API call is isolated to draft creation.
Documentation
- Quickstart
- Install
- Authentication
- OAuth2 PKCE Tutorial
- Configuration
- Usage
- Markdown Syntax
- X API Contract
- Agent Guide
- Troubleshooting
Contributing
Contributing? Read CONTRIBUTING.md before opening a PR.
License
AGPL-3.0-only. Commercial licenses are available; see COMMERCIAL.md.
