docs: update README with project description, features, and tech stack

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: mertguvencli

README.md

@@ -1,36 +1,67 @@
-This is a [Next.js](https://nextjs.org) project bootstrapped with [`create-next-app`](https://nextjs.org/docs/app/api-reference/cli/create-next-app).
+# MarkBloom
 
-## Getting Started
+Free, open-source Markdown to PDF converter that runs entirely in your browser. Write Markdown, see a live preview, and export beautifully formatted PDFs — no sign-up, no server uploads. Your content never leaves your device.
+
+[Live Demo](https://mertguvencli.github.io/markbloom)
+
+![Next.js](https://img.shields.io/badge/Next.js-16-black?logo=next.js)
+![React](https://img.shields.io/badge/React-19-61DAFB?logo=react)
+![TypeScript](https://img.shields.io/badge/TypeScript-5-3178C6?logo=typescript)
+![License](https://img.shields.io/badge/License-MIT-green)
 
-First, run the development server:
+## Features
+
+- **Live Editor** — CodeMirror 6 powered Markdown editor with syntax highlighting
+- **Real-Time Preview** — Instant side-by-side preview as you type
+- **PDF Export** — One-click export with smart pagination and page break detection
+- **Multiple Page Sizes** — A4, US Letter, and Legal support
+- **GitHub Flavored Markdown** — Tables, task lists, strikethrough, and more
+- **Syntax Highlighting** — 100+ languages with Shiki (GitHub Dark theme)
+- **100% Client-Side** — Zero backend, zero data collection, complete privacy
+
+## Getting Started
 
 ```bash
-npm run dev
-# or
-yarn dev
-# or
+# Clone the repository
+git clone https://github.com/mertguvencli/markbloom.git
+cd markbloom
+
+# Install dependencies
+pnpm install
+
+# Start development server
 pnpm dev
-# or
-bun dev
 ```
 
-Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
+Open [http://localhost:3000](http://localhost:3000) in your browser.
 
-You can start editing the page by modifying `app/page.tsx`. The page auto-updates as you edit the file.
+## Tech Stack
 
-This project uses [`next/font`](https://nextjs.org/docs/app/building-your-application/optimizing/fonts) to automatically optimize and load [Geist](https://vercel.com/font), a new font family for Vercel.
+| Category | Technology |
+|---|---|
+| Framework | Next.js 16, React 19, TypeScript |
+| Editor | CodeMirror 6 |
+| Markdown | React Markdown, Remark GFM, Rehype Raw |
+| Code Highlighting | Shiki |
+| Styling | Tailwind CSS 4, shadcn/ui, Radix UI |
+| PDF Generation | html2canvas-pro, jsPDF |
 
-## Learn More
+## Build & Deploy
 
-To learn more about Next.js, take a look at the following resources:
+```bash
+# Production build
+pnpm build
+
+# Start production server
+pnpm start
+```
 
-- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API.
-- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.
+The project is configured for static export and can be deployed to GitHub Pages or any static hosting provider.
 
-You can check out [the Next.js GitHub repository](https://github.com/vercel/next.js) - your feedback and contributions are welcome!
+## Contributing
 
-## Deploy on Vercel
+Contributions are welcome! Feel free to open issues and pull requests.
 
-The easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template&filter=next.js&utm_source=create-next-app&utm_campaign=create-next-app-readme) from the creators of Next.js.
+## License
 
-Check out our [Next.js deployment documentation](https://nextjs.org/docs/app/building-your-application/deploying) for more details.
+[MIT](LICENSE)