A command-line utility that transforms markdown articles into platform-optimized social media posts for Twitter, LinkedIn, and Reddit.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install markdown-to-social
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install markdown-to-social using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Markdown to Social Converter?
This skill bridges the gap between long-form technical writing and high-engagement social media content. It automates the tedious process of manual content repurposing by applying platform-specific formatting rules, such as character limits, thread numbering, and engagement hooks. By integrating this into your workflow, you can ensure your Openclaw Skills driven content reaches a wider audience across various social ecosystems without manual rewriting. The tool is designed to be lightweight and fast, requiring only a standard Python environment.
Markdown to Social Converter Use Cases
- Turning a technical blog post into a structured Twitter thread with numbered tweets.
- Repurposing documentation into a professional LinkedIn engagement post with emoji bullets.
- Drafting Reddit community posts with automatic TL;DR summaries and preserved markdown headers.
- Batch processing multiple articles for a multi-platform social media campaign using JSON output.
How Markdown to Social Converter Works
- The script parses the input Markdown file or direct text string to identify headers and content blocks.
- Based on the selected platform flag, it applies specific heuristic rules like character counts for Twitter or emoji formatting for LinkedIn.
- For Twitter, it intelligently splits text into a numbered thread (1/N) while ensuring sentences aren't cut mid-way.
- For LinkedIn, it generates a visible hook paragraph and appends relevant hashtags at the end.
- For Reddit, it extracts a title and prepends a TL;DR section while maintaining the original markdown formatting.
- The final output is printed to the console, saved to designated files, or returned as a JSON object.
Markdown to Social Converter Setup
Ensure you have Python 3.10 or higher installed. This skill relies exclusively on the Python standard library, so no pip installs are necessary.
# Verify your Python version
python3 --version
# Run the converter on a markdown file
python3 scripts/md2social.py convert article.md --all
Markdown to Social Converter Data Schema & Taxonomy
The skill manages content through clear input/output mappings. Use the following schema for organizing your Openclaw Skills workflow:
| Input Format | Description |
|---|---|
| Markdown File | Standard .md file containing headers and body content. |
| Direct Text | String input via the --text flag for quick conversions. |
| Output Asset | Specification |
|---|---|
| twitter.txt | Numbered thread pieces, strictly under 280 characters each. |
| linkedin.txt | Single post with line breaks and 5-8 hashtags. |
| reddit.md | Reddit-ready markdown with a TL;DR at the top. |
| JSON | Raw data for programmatic automation. |
Markdown to Social Converter Advanced Features
- Multi-platform generation in a single command using the --all flag for rapid distribution.
- JSON output mode to integrate with external publishing APIs or headless CMS workflows.
- Smart sentence-splitting logic to prevent awkward breaks in the middle of thoughts on Twitter.
- Custom output directory support to keep your social media assets organized per campaign.
SKILL.md
Loading
Related Openclaw Skills
Legal Docs FR
A Python-powered CLI generator for French legal documents, creating print-ready HTML for CGV, contracts, and quotes for freelancers.
French Services Skill
A comprehensive suite of Python scripts for accessing real-time French transport, logistics, and weather data.
Freelance Toolkit
A lightweight Python-based command-line toolkit for French freelancers to manage clients, track time, and generate professional HTML invoices.
Deploy Kit
An automated deployment utility that simplifies launching web applications to Vercel, Railway, and Supabase via integrated CLI workflows.
Price Monitor
An automated tool to track e-commerce prices and receive alerts for price drops or reached targets.
ADMET Prediction
Accelerate drug discovery by predicting ADMET properties and safety risks for chemical compounds using advanced ML models.
Featured*
