Back to Projects

Markdown to HTML Converter

PythonFlaskJavaScriptHTMLCSSVercelRegexPytest
Markdown to HTML Converter

A full-stack Markdown to HTML converter featuring both a CLI tool and a live web application. This project demonstrates Python backend development, serverless deployment, and frontend integration: - CLI Tool: Command-line interface supporting single file and batch conversions with customizable options for themes, table of contents, and output formatting. - Web Application: Real-time browser-based converter with live preview, file upload support, and instant HTML download functionality. - Markdown Parser: Custom-built regex-based parser supporting headers (h1-h6), bold, italic, links, images, ordered/unordered lists, code blocks with syntax highlighting, blockquotes, and horizontal rules. - Theming System: Professional light and dark themes with GitHub-flavored styling, CSS custom properties, and responsive design. - Table of Contents: Automatic TOC generation from document headers with anchor links for easy navigation. - Testing: Comprehensive test suite with 73 unit tests covering parser and converter functionality.

Challenges

  • Building a robust Markdown parser using regex patterns
  • Deploying Python serverless functions on Vercel
  • Creating real-time preview without performance issues
  • Supporting file uploads and downloads in the browser

What I Learned

  • Python serverless function architecture for Vercel
  • Regex pattern design for text parsing
  • Building developer tools that solve real problems
  • Full-stack development from CLI to web deployment