A professional, cross-platform markdown reader built with Electron featuring modern UI/UX, syntax highlighting, and advanced features
Markdown Reader Pro is a sophisticated desktop application that transforms how developers, writers, and technical professionals read and interact with markdown documents. Built with modern web technologies and packaged as a native desktop app, it delivers a premium reading experience with enterprise-grade features.
- Professional Needs: Traditional text editors lack the polished reading experience needed for technical documentation
- Cross-Platform Consistency: Provides the same excellent experience across Windows, macOS, and Linux
- Developer Experience: Built by developers, for developers - with attention to detail that matters
- Modern UI/UX: Leverages contemporary design principles for an intuitive, accessible interface
- Syntax Highlighting: Powered by highlight.js with GitHub Dark theme
- Multiple Themes: Light, Dark, and Auto (system preference) modes
- Responsive Design: Adapts seamlessly to any screen size or resolution
- Typography Control: Adjustable font sizes and line heights for optimal readability
- Drag & Drop: Intuitive file loading with visual feedback
- Keyboard Shortcuts: Power-user shortcuts for efficient navigation
- File Management: Recent files, file info display, and path copying
- Accessibility: ARIA labels, keyboard navigation, and screen reader support
- Export Options: Convert to HTML with custom styling
- Print Support: Optimized printing with proper page breaks
- Settings Persistence: User preferences saved across sessions
- Error Handling: Graceful error states with helpful recovery options
- Fast Rendering: Optimized markdown parsing with marked.js
- Memory Efficient: Lightweight Electron implementation
- Cross-Platform: Native builds for Windows, macOS, and Linux
- Auto-Updates: Built-in update mechanism for seamless maintenance
- Node.js 18+ and npm 9+
- Git for cloning the repository
# Clone the repository
git clone https://github.com/Dragon745/Markdown-Reader.git
cd Markdown-Reader
# Install dependencies
npm install
# Start development mode
npm start
# Build for production
npm run build# Windows
npm run build:win:prod
# macOS
npm run build:mac:prod
# Linux
npm run build:linux:prod- Launch: Double-click the executable or run from command line
- Open File: Use
Ctrl+O(orCmd+Oon macOS) or drag & drop - Customize: Access settings via the gear icon in the header
- Export: Use the export button to save as HTML
- Technical Documentation: Read API docs, architecture guides, and design specs
- Code Reviews: View markdown-based PR descriptions and review comments
- Knowledge Sharing: Access team wikis and shared documentation
- Project READMEs: Professional reading experience for open-source projects
- Personal Notes: Clean interface for technical journals and learning notes
- Portfolio: Present markdown-based portfolios with polished formatting
- Technical Writing: Distraction-free environment for writing technical content
- Documentation: Create and preview documentation before publishing
- Presentations: Convert markdown to HTML for web-based presentations
- Course Materials: Read lecture notes and course documentation
- Research Papers: Clean interface for academic markdown documents
- Collaboration: Share and review group project documentation
- HTML5: Semantic markup with accessibility features
- CSS3: Modern styling with CSS custom properties and flexbox
- JavaScript (ES6+): Modern JavaScript with async/await and modules
- Electron 28.0.0: Cross-platform desktop application framework
- Node.js Integration: File system access and native OS integration
- IPC Communication: Secure main-renderer process communication
- marked.js 9.1.6: Fast markdown parser with GFM support
- highlight.js 11.9.0: Syntax highlighting for 190+ programming languages
- Custom Renderer: Optimized HTML output with semantic markup
- electron-builder: Professional packaging and distribution
- Multi-platform: Windows (NSIS, Portable), macOS (DMG), Linux (AppImage, DEB)
- Auto-updates: GitHub releases integration
We welcome contributions from the community! Here's how you can help:
- Fork the repository
- Create a feature branch:
git checkout -b feature/amazing-feature - Make your changes and test thoroughly
- Commit with clear messages:
git commit -m 'Add amazing feature' - Push to your branch:
git push origin feature/amazing-feature - Open a Pull Request
- Follow existing code style and patterns
- Add tests for new functionality
- Update documentation for API changes
- Ensure cross-platform compatibility
- Test on multiple operating systems
- UI/UX Improvements: Better accessibility, responsive design
- Performance: Optimize rendering, reduce memory usage
- Features: Additional export formats, plugin system
- Documentation: Better examples, tutorials, API docs
- Testing: Unit tests, integration tests, E2E tests
This project is licensed under the MIT License - see the LICENSE file for details.
The MIT License is one of the most permissive open-source licenses, allowing:
- β Commercial use
- β Modification and distribution
- β Private use
- β Patent use
- β Only requires license and copyright notice preservation
- Electron Team: For the amazing cross-platform framework
- marked.js Contributors: For the excellent markdown parser
- highlight.js Team: For comprehensive syntax highlighting
- Open Source Community: For inspiration and collaboration
- Issues: GitHub Issues
- Discussions: GitHub Discussions
- Wiki: Project Wiki
- Portfolio: syedqutubuddin.in
- AI Bot: psychebot.pro
- Web Services: website14.com
- Buy Me a Coffee: buymeacoffee.com/contact9rg
Made with β€οΈ by the Syed Qutubudddin B Asadi
If this project helps you, please consider giving it a βοΈ