Initial commit

Author: auy

.github/workflows/ci.yml

@@ -0,0 +1,19 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  build-and-lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+      - run: npm ci
+      - run: npm run build:chrome
+      - run: npm run lint

.gitignore

@@ -0,0 +1,17 @@
+node_modules/
+dist/
+artifacts/
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# Editor
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# Claude Code
+.claude/
+CLAUDE.md

.npmrc

@@ -0,0 +1 @@
+engine-strict=true

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 auy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,75 @@
+# HTML2MD
+
+A browser extension that adds a sidebar to DevTools for converting selected HTML elements to Markdown. Supports Chrome, Edge, and Firefox.
+
+## Features
+
+- Select any element in the Elements inspector and instantly see its Markdown conversion
+- Live preview of the rendered Markdown
+- Copy to clipboard or download as `.md` file
+- Strips scripts, styles, and unnecessary attributes automatically
+
+## Install from Store
+
+*Coming soon* - Chrome Web Store | Firefox Add-ons | Edge Add-ons
+
+## Development
+
+### Prerequisites
+
+- Node.js 20+
+- npm
+
+### Setup
+
+```bash
+git clone https://github.com/auy/HTML2MD.git
+cd html2md
+npm install
+```
+
+### Build
+
+```bash
+npm run build              # Production build (Chrome/Edge)
+npm run build:firefox      # Production build (Firefox)
+```
+
+### Run with Auto-Install
+
+```bash
+npm run start:chrome       # Chrome (auto-downloads Chrome for Testing)
+npm run start:edge         # Microsoft Edge
+npm run start:firefox      # Mozilla Firefox
+```
+
+Open DevTools (F12) > Elements tab > look for the **HTML2MD** sidebar tab.
+
+### Other Commands
+
+```bash
+npm run dev                # Watch mode (rebuilds on file changes)
+npm run lint               # Validate extension with web-ext lint
+npm run package            # Zip dist/ for store submission
+```
+
+## Cross-Platform Support
+
+Works on Windows, macOS, Linux, and WSL. Platform detection is automatic.
+
+## How It Works
+
+1. **Cleaning** - Strips `<script>`, `<style>`, `<noscript>` tags and non-essential attributes
+2. **Conversion** - [Turndown](https://github.com/mixmark-io/turndown) converts HTML to Markdown (ATX headings, fenced code blocks, GFM strikethrough)
+3. **Preview** - [marked](https://github.com/markedjs/marked) renders the Markdown back to HTML for preview
+
+## Contributing
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/my-feature`)
+3. Commit your changes
+4. Push to the branch and open a Pull Request
+
+## License
+
+[MIT](LICENSE)