{"id":30821051,"url":"https://github.com/jqueryscript/markdown-to-html","last_synced_at":"2025-09-06T10:12:16.287Z","repository":{"id":310004780,"uuid":"1038002493","full_name":"jqueryscript/markdown-to-html","owner":"jqueryscript","description":"Free, privacy-first, AI-first Markdown to HTML converter with real-time preview, advanced customization, and clean, semantic output.","archived":false,"fork":false,"pushed_at":"2025-08-27T02:12:26.000Z","size":187,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-27T10:52:01.859Z","etag":null,"topics":["markdown","markdown-to-html"],"latest_commit_sha":null,"homepage":"https://www.markdownhtmlgen.com/","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jqueryscript.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-14T13:13:39.000Z","updated_at":"2025-08-27T02:12:30.000Z","dependencies_parsed_at":"2025-08-15T05:29:04.806Z","dependency_job_id":"8d5bf15d-e797-4420-88db-d23504e62324","html_url":"https://github.com/jqueryscript/markdown-to-html","commit_stats":null,"previous_names":["jqueryscript/markdown-to-html"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/jqueryscript/markdown-to-html","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jqueryscript%2Fmarkdown-to-html","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jqueryscript%2Fmarkdown-to-html/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jqueryscript%2Fmarkdown-to-html/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jqueryscript%2Fmarkdown-to-html/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jqueryscript","download_url":"https://codeload.github.com/jqueryscript/markdown-to-html/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jqueryscript%2Fmarkdown-to-html/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273888179,"owners_count":25185826,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-06T02:00:13.247Z","response_time":2576,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["markdown","markdown-to-html"],"created_at":"2025-09-06T10:11:07.137Z","updated_at":"2025-09-06T10:12:16.268Z","avatar_url":"https://github.com/jqueryscript.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Markdown Tools\n\n**Live Website:** [https://www.markdownhtmlgen.com/](https://www.markdownhtmlgen.com/)\n\nA comprehensive suite of privacy-first Markdown utilities with unified branding and seamless navigation. Convert between Markdown and HTML, edit with WYSIWYG features, and process all content client-side for maximum privacy.\n\n## 🚀 Features\n\n### Core Tools\n- **[Markdown to HTML Converter](https://www.markdownhtmlgen.com/)** - Convert Markdown to clean, semantic HTML with real-time preview\n- **[HTML to Markdown Converter](https://www.markdownhtmlgen.com/html-to-markdown-converter/)** - Reverse conversion from HTML back to Markdown format\n- **[WYSIWYG Markdown Editor](https://www.markdownhtmlgen.com/markdown-editor/)** - Real-time WYSIWYG editor using OverType library for perfect character alignment\n\n### Key Features\n- ✅ **Privacy-First**: All processing done client-side, no server uploads\n- ✅ **Real-time Preview**: Live conversion and preview for all tools\n- ✅ **File Upload Support**: Drag \u0026 drop .md and .html files\n- ✅ **Mobile Responsive**: Complete mobile navigation with sidebar menu\n- ✅ **Unified Navigation**: Seamless switching between all tools\n- ✅ **AI Content Friendly**: Optimized output for AI content workflows\n- ✅ **Theme Support**: Light/dark themes for WYSIWYG editor\n- ✅ **Export Functions**: Download results as files\n\n## 🛠️ Technologies Used\n\n- **Frontend**: Vanilla JavaScript with ES6+ features\n- **Styling**: Tailwind CSS v4 with PostCSS processing  \n- **Markdown Processing**: Marked.js library\n- **HTML to Markdown**: Turndown.js library\n- **WYSIWYG Editor**: OverType.js library (invisible textarea overlay)\n- **Build Tools**: PostCSS, Terser for minification\n\n## 📁 Project Structure\n\n```\n├── index.html                     # Main Markdown to HTML converter\n├── script.js                      # Main converter logic with mobile menu\n├── input.css                      # Tailwind CSS source\n├── style.css                      # Generated CSS (built from input.css)\n├── package.json                   # Dependencies and build scripts\n├── postcss.config.js              # PostCSS configuration\n├── html-to-markdown-converter/\n│   ├── index.html                 # HTML to Markdown converter\n│   └── script.js                  # Conversion logic using Turndown\n├── markdown-editor/\n│   ├── index.html                 # WYSIWYG Markdown Editor\n│   └── overtype-main/             # OverType library files\n│       ├── dist/overtype.min.js\n│       ├── README.md\n│       └── demo.html\n└── markdown-to-pdf-converter/     # [DISABLED - has bugs]\n    ├── index.html                 \n    └── script.js                  \n```\n\n## 🚀 Getting Started\n\n### Prerequisites\n\nEnsure you have Node.js and npm installed on your system.\n\n### Installation\n\n1. **Clone the repository:**\n   ```bash\n   git clone https://github.com/jqueryscript/markdown-to-html.git\n   cd markdown-to-html\n   ```\n\n2. **Install dependencies:**\n   ```bash\n   npm install\n   ```\n\n### Development Commands\n\n```bash\n# Build CSS from Tailwind source\nnpm run build:css\n\n# Build JavaScript (minify)\nnpm run build:js\n\n# Build both CSS and JavaScript\nnpm run build\n```\n\n### Running the Project\n\nThis is a static website. You can:\n\n1. **Open directly in browser**: Open `index.html` to access the main converter\n2. **Use a local server** (recommended for development):\n   ```bash\n   # Install live-server globally\n   npm install -g live-server\n   \n   # Run from project root\n   live-server\n   ```\n\n### Navigation Structure\n\n```\nMarkdown Tools (Brand)\n├── Markdown to HTML (/)\n├── HTML to Markdown (/html-to-markdown-converter/)\n├── WYSIWYG Editor (/markdown-editor/)\n└── Markdown Guide (#markdown anchor)\n```\n\n## 🎨 Architecture \u0026 Design\n\n### Unified Branding\n- **Brand Name**: \"Markdown Tools\" across all pages\n- **Consistent Navigation**: Cross-page links and mobile sidebar\n- **Mobile-First**: Responsive design with hamburger menu\n- **SEO Optimized**: Structured data and proper internal linking\n\n### WYSIWYG Editor Implementation\n```javascript\n// OverType library integration pattern\nconst OT = window.OverType.default || window.OverType;\nconst [editor] = new OT('#editor-container', {\n    value: 'initial content',\n    toolbar: true,\n    showStats: true,\n    theme: 'solar' // or 'cave'\n});\n```\n\n### Key Features\n- **Perfect WYSIWYG Alignment**: Invisible textarea overlay technique\n- **Smart Lists**: Automatic list continuation and numbering\n- **Keyboard Shortcuts**: Ctrl+B (bold), Ctrl+I (italic), etc.\n- **Export Functions**: Download as Markdown or HTML\n\n## 🔧 Development Notes\n\n- **CSS Processing**: Always run `npm run build:css` after modifying `input.css`\n- **JavaScript**: Modular structure with respective `script.js` files\n- **OverType Library**: Located in `/markdown-editor/overtype-main/dist/`\n- **Mobile Menu**: JavaScript functionality for sidebar toggle\n- **Cross-Page Links**: Use relative paths for proper navigation\n- **Browser Support**: Modern browsers only (ES6+, no IE support)\n\n## 🚀 Deployment\n\nStatic site deployment - upload all files to any web server. Ensure:\n\n- ✅ `style.css` is built and up-to-date\n- ✅ All converter pages maintain directory structure  \n- ✅ OverType library files are included\n- ✅ External CDN dependencies are accessible\n- ✅ Cross-page navigation links work properly\n\n## 🐛 Known Issues\n\n- **Markdown to PDF**: Tool has bugs and is currently disabled/excluded from navigation\n- **OverType Constructor**: Must use `window.OverType.default || window.OverType` pattern  \n- **Mobile Menu**: Requires JavaScript for sidebar toggle functionality\n\n## 🤝 Contributing\n\n1. Fork the repository\n2. Create a feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n## 📄 License\n\nThis project is open source and available under the [MIT License](LICENSE).\n\n---\n\n**Created by [jQueryScript](https://www.jqueryscript.net)** | **© 2025 markdownhtmlgen.com**","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjqueryscript%2Fmarkdown-to-html","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjqueryscript%2Fmarkdown-to-html","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjqueryscript%2Fmarkdown-to-html/lists"}