@alvincrespo/hashnode-content-converter

Convert Hashnode blog exports to framework-agnostic Markdown with YAML frontmatter.

Features

• Converts Hashnode export JSON to clean Markdown files
• Generates YAML frontmatter with metadata (title, date, tags, etc.)
• Downloads and localizes images from Hashnode CDN
• Handles Hashnode-specific markdown quirks (align attributes, etc.)
• Provides both CLI and programmatic APIs
• Includes progress tracking and event-based monitoring

Quick Links

• Getting Started - Installation and basic usage
• CLI Usage - Command-line interface reference
• Programmatic API - Using the converter in your code
• Advanced Usage - Custom processors and event handling

Installation

npm install @alvincrespo/hashnode-content-converter
Copy

Quick Start

CLI

npx @alvincrespo/hashnode-content-converter convert \
  --export ./hashnode-export.json \
  --output ./blog/posts
Copy

Programmatic

import { Converter } from '@alvincrespo/hashnode-content-converter';

const result = await Converter.fromExportFile('./export.json', './blog');
console.log(`Converted ${result.converted} posts`);
Copy

Links

• GitHub Repository
• npm Package
• Issue Tracker