Markdown Publisher Toolkit

Convert dev.to articles to optimized HTML with SEO, accessibility, and inline CSS processing.

Badges

Dev Dependencies

---

Features ✨

• Dev Community Integration - Fetch articles directly from dev.to API
• Markdown Processing - Clean, semantic HTML conversion
• SEO & Accessibility - Meta tags, ARIA labels, semantic structure
• CSS Inlining - Platform-ready styling
• Export Options - Copy to clipboard or download HTML

---

Quick Start 🚀

Prerequisites: Node.js 18+ and modern browser

git clone https://github.com/your-username/markdown-publisher-toolkit.git
cd markdown-publisher-toolkit
npm install
npm run dev

Visit http://localhost:3000 to start converting articles.

How to Use 📖

1. Paste a dev.to article URL
2. Click "Convert Article"
3. Preview the result
4. Copy or download the HTML

Supported URLs:

• https://dev.to/username/article-title
• https://dev.to/organization/article-title

🧪 Testing

npm test            # Full test suite with coverage
npm run test:unit   # Unit tests only
npm run test:integration # Browser tests

---

Current Status: 85% minimum coverage maintained

Development 🛠️

Project Structure:

src/
├── components/     # React UI components
├── services/       # Business logic (API, processors)
├── hooks/         # Custom React hooks
├── types/         # TypeScript definitions
└── App.tsx        # Main application

Scripts:

npm run dev         # Development server
npm run build       # Production build
npm run lint        # Code linting
npm run format      # Code formatting

---

Contributing 🤝

1. Install dependencies: npm install
2. Install Playwright: npx playwright install
3. Install git hooks: npx lefthook install
4. Run tests: npm test

Requirements:

• 85% test coverage minimum
• TypeScript strict mode
• ESLint + Prettier compliance
• Conventional Commits format

---

License 📄

Every project has to have a stack of fine print somewhere. Keep going, keep going, keep going... Here's mine, as painless as possible:

You know where the license is, but I'll sum it up: this is not open source (even though you can still do just about anything you want with it). As long as you're not turning it into the next big SaaS or selling subscriptions in the cloud, then have fun! Else, you've gotta ask me first.

Basically? This project's got boundaries. Be cool, don't try to sneak it into a product launch, and we'll get along just fine. 😘

---

Acknowledgments 🙏

• Coder Legion: For the inspiration—and for letting me ask a million questions.
  • Seriously, Andrew had no idea what he was signing up for, but deserves a medal for surviving the process. 🏅
• Dev Community: For providing an excellent API, an even better platform, and the kind of dev crowd that makes all of this even remotely possible.
  • Without y'all, this project probably wouldn't exist in the first place.

The ones who had no idea they helped

...but this would've been impossible without them

• Unified Ecosystem: For all the markdown magic under the hood. Seriously, your tools just work.
• Verdent Team: For building the kind of platform that makes "just one more experiment" dangerously easy.

---

Contact 📧

• Project Maintainer: Ashley Childress
• Email: human@checkmarkdevtools.dev

---

🛡️ This project was created with the help of AI.