chore: initial project setup

- Git repository mit .gitignore und .editorconfig
- NPM-Projekt mit package.json und Dependencies
- Projekt-Struktur (src/, docs/, examples/, test/)
- Umfassende README.md mit Features und Roadmap
- Architektur-Dokumentation mit Mermaid-Diagrammen
- Design-Entscheidungen dokumentiert
- .env.example für Forgejo API-Konfiguration
- MIT Lizenz und Contributing Guidelines

Status: Phase 1 - Core Parser (Setup abgeschlossen)

CONTRIBUTING.md

@@ -0,0 +1,82 @@
+# Contributing to MDParser
+
+Vielen Dank für dein Interesse an MDParser! 🎉
+
+## 🚀 Quick Start
+
+1. **Fork & Clone**
+   ```bash
+   git clone https://git.rpi-virtuell.de/dein-username/mdparser.git
+   cd mdparser
+   ```
+
+2. **Dependencies installieren**
+   ```bash
+   npm install
+   ```
+
+3. **Branch erstellen**
+   ```bash
+   git checkout -b feature/mein-feature
+   ```
+
+4. **Entwickeln & Testen**
+   ```bash
+   npm test
+   npm run lint
+   ```
+
+5. **Commit & Push**
+   ```bash
+   git commit -m "feat: beschreibung"
+   git push origin feature/mein-feature
+   ```
+
+6. **Pull Request erstellen**
+
+## 📝 Code-Style
+
+- **ESLint** für Linting
+- **Prettier** für Formatierung
+- **ESM** (ES Modules) verwenden
+- **JSDoc** für Funktions-Dokumentation
+
+```javascript
+/**
+ * Parst eine Markdown-Datei mit YAML Front Matter
+ * @param {string} filePath - Pfad zur Markdown-Datei
+ * @param {Object} options - Optionale Konfiguration
+ * @returns {Promise<Object>} Parsed result
+ */
+export async function parseMarkdownFile(filePath, options = {}) {
+  // ...
+}
+```
+
+## 🧪 Testing
+
+- Alle neuen Features benötigen Tests
+- Tests mit `npm test` ausführen
+- Test-Fixtures in `test/fixtures/` ablegen
+
+## 📦 Commit-Conventions
+
+Wir verwenden [Conventional Commits](https://www.conventionalcommits.org/):
+
+- `feat:` - Neues Feature
+- `fix:` - Bugfix
+- `docs:` - Dokumentation
+- `test:` - Tests
+- `refactor:` - Code-Refactoring
+- `chore:` - Maintenance
+
+Beispiele:
+```
+feat: add WordPress transformer
+fix: handle missing YAML gracefully
+docs: update API documentation
+```
+
+## 📄 Lizenz
+
+MIT - siehe [LICENSE](LICENSE)