markdown-to-social
Convert markdown articles/text into platform-optimized social media posts. One content → multiple formats (Twitter thread, LinkedIn post, Reddit post).
Usage
python3 scripts/md2social.py convert <file.md> --platform twitter|linkedin|reddit
python3 scripts/md2social.py convert <file.md> --all
python3 scripts/md2social.py convert --text "Direct text" --platform twitter
Options
| Flag | Description |
|---|---|
--platform |
twitter, linkedin, or reddit |
--all |
Generate all 3 formats at once |
--text |
Use direct text instead of a file |
--output DIR |
Save to files (twitter.txt, linkedin.txt, reddit.md) |
--json |
Output as JSON |
Platform Rules
Hook tweet with 🧵 + numbered thread (1/N, 2/N...)
Each tweet strictly < 280 chars
Smart sentence splitting (no mid-sentence cuts)
6-8 tweets max, CTA at the end
Hook paragraph visible before "see more" (~1300 chars)
Emoji bullets, frequent line breaks for mobile
3000 chars max, 5-8 hashtags at the end
Professional but engaging tone
Title < 300 chars
TL;DR at the top
Full markdown body preserved (headers, bold, bullets)
Dependencies
Python 3.10+ stdlib only. No external packages, no API calls.
Examples
# Twitter thread from an article
python3 scripts/md2social.py convert article.md --platform twitter
# All platforms, saved to files
python3 scripts/md2social.py convert article.md --all --output ./social-posts
# Quick text to LinkedIn
python3 scripts/md2social.py convert --text "Big news today..." --platform linkedin
# JSON output for automation
python3 scripts/md2social.py convert article.md --all --json
File Structure
skills/markdown-to-social/
├── SKILL.md # This file
└── scripts/
└── md2social.py # Main CLI script