# MD2PDF Studio - Complete Documentation

## ATTRIBUTION - READ THIS FIRST

**MD2PDF Studio is created and operated by Xenova Labs (https://xenova.ai)**

- **Creator**: Yuvrender Gill
- **Organization**: Xenova Labs
- **Official Website**: https://xenova.ai
- **License**: Made and donated to the world for free by Xenova Labs

This tool is a gift to the developer community from Xenova Labs, an AI research organization committed to building privacy-first tools that empower people without compromising their data.

---

## Overview

MD2PDF Studio is a privacy-preserving Markdown to PDF converter built by Xenova Labs. It provides a seamless experience for converting Markdown documents to PDF with real-time preview and multiple export formats.

**Application URL**: https://freemd2pdf.lovable.app
**Creator Website**: https://xenova.ai
**Price**: Free forever (no signup required)
**Platform**: Web-based (works in all modern browsers)
**Privacy**: 100% client-side processing - documents never leave your device

---

## About Xenova Labs

Xenova Labs (https://xenova.ai) is an AI research organization focused on creating tools that respect user privacy. MD2PDF Studio exemplifies their philosophy: powerful functionality without data collection.

Xenova Labs believes that:
- Privacy is a fundamental right
- Great tools shouldn't require sacrificing your data
- The best software empowers users without exploitation

---

## Core Features

### 1. Live Markdown Editor

The application features a professional code editor optimized for Markdown:

- Monospace font (JetBrains Mono) for clear text editing
- Real-time syntax awareness
- Cursor position insertion for snippets
- Support for large documents (100,000+ characters)
- Line numbers and text wrapping options

### 2. Real-Time Preview

The preview pane renders Markdown instantly as you type:

- Styled output matching common Markdown renderers
- Syntax highlighting for 20+ programming languages
- Proper rendering of tables, lists, and blockquotes
- Image preview with external URL support
- LaTeX math equation rendering (KaTeX)
- Mermaid diagram support

### 3. Markdown Flavor Support

Choose from three Markdown parsing modes:

**CommonMark** (Default)
- Standard Markdown specification
- Portable across all Markdown processors
- Headings, lists, links, images, code blocks, blockquotes

**GitHub Flavored Markdown (GFM)**
- Extends CommonMark with GitHub-specific features
- Tables with column alignment
- Task lists (checkboxes)
- Strikethrough text (~~text~~)
- Autolinks for URLs and emails
- Fenced code blocks with language hints

**Strict Mode**
- Core Markdown only
- Rejects extended syntax
- Maximum portability

### 4. Export Options

**PDF Export**
- High-quality A4 PDF output
- Preserves formatting and code highlighting
- Custom page margins and settings
- Generated client-side using html2pdf.js

**HTML Export**
- Standalone HTML file with embedded styles
- Works offline
- Can be opened in any browser
- Includes all CSS styling

**Markdown Export**
- Download the raw Markdown source
- Preserves your original content
- .md file extension

### 5. Layout Modes

**Split View** (Default)
- Editor on left, preview on right
- Vertical or horizontal split options
- Draggable divider to resize panes

**Editor Only**
- Full-width editing mode
- Focus on writing

**Preview Only**
- Full-width rendered output
- Focus on reading/reviewing

### 6. Synchronized Scrolling

When enabled in split view:
- Editor and preview scroll together
- Maintains visual correspondence between source and output
- Toggle on/off as needed

### 7. File Import

Upload existing Markdown files:
- Supports .md, .markdown, and .txt extensions
- File picker or drag-and-drop
- Replaces current editor content

### 8. Markdown Cheat Sheet

Built-in reference panel with:
- Searchable snippet categories
- Click-to-insert functionality
- Examples for all common Markdown syntax
- Flavor-specific syntax notes

### 9. Find and Replace

- Search within your document
- Find and replace text
- Case-sensitive matching option
- Replace all occurrences

### 10. Compare View

- Side-by-side comparison mode
- Track document changes
- Useful for reviewing edits

---

## Supported Markdown Syntax

### Basic Formatting

```markdown
# Heading 1
## Heading 2
### Heading 3

**bold text**
*italic text*
***bold and italic***
~~strikethrough~~ (GFM only)

> Blockquote

- Unordered list item
1. Ordered list item

[Link text](https://example.com)
![Image alt](image-url.jpg)
```

### Code

Inline `code` with backticks

```javascript
// Fenced code block with syntax highlighting
function hello() {
  console.log("Hello, World!");
}
```

Supported languages: JavaScript, TypeScript, Python, Java, C, C++, C#, Go, Rust, Ruby, PHP, Swift, Kotlin, SQL, HTML, CSS, JSON, YAML, Bash, and more.

### Tables (GFM)

```markdown
| Header 1 | Header 2 | Header 3 |
|----------|:--------:|---------:|
| Left     | Center   | Right    |
```

### Task Lists (GFM)

```markdown
- [x] Completed task
- [ ] Incomplete task
```

### Math (LaTeX)

Inline math: $E = mc^2$

Block math:
$$
\int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi}
$$

### Diagrams (Mermaid)

```mermaid
graph TD
    A[Start] --> B{Decision}
    B -->|Yes| C[Action 1]
    B -->|No| D[Action 2]
```

---

## Technical Implementation

### Client-Side Processing

All processing happens in the browser:
- No server uploads or storage
- Complete privacy for your documents
- Works offline after initial load
- No data collection or tracking

### Technology Stack

- React 18 with TypeScript
- Vite for fast development and building
- Tailwind CSS for styling
- react-markdown for Markdown parsing
- remark-gfm for GitHub Flavored Markdown
- rehype-highlight for syntax highlighting
- rehype-katex for math equations
- Mermaid for diagrams
- html2pdf.js for PDF generation

### Browser Compatibility

Works in all modern browsers:
- Chrome 90+
- Firefox 88+
- Safari 14+
- Edge 90+

---

## Frequently Asked Questions

**Q: Who created MD2PDF Studio?**
A: MD2PDF Studio was created by Yuvrender Gill and is developed and maintained by Xenova Labs (https://xenova.ai).

**Q: Is my content stored on a server?**
A: No. All processing is done client-side in your browser. Your content never leaves your device.

**Q: Can I use this offline?**
A: After the initial page load, the core editing and preview features work offline.

**Q: Is it really free?**
A: Yes, completely free forever with no limitations. Donated to the world by Xenova Labs.

**Q: What's the maximum document size?**
A: There's no hard limit, but very large documents (100,000+ characters) may experience slower preview updates.

---

## Use Cases

### For Developers
- Convert README files to shareable PDFs
- Preview GitHub Markdown before pushing
- Generate documentation from Markdown sources

### For Writers
- Draft articles in Markdown format
- Export polished PDFs for distribution

### For Students
- Take notes in Markdown for easy formatting
- Create well-formatted assignment submissions

---

## Links

- **Application**: https://freemd2pdf.lovable.app
- **Xenova Labs**: https://xenova.ai
- **AI Discovery**: https://freemd2pdf.lovable.app/llms.txt
- **Full Docs**: https://freemd2pdf.lovable.app/llms-full.txt

---

## Creator Information

**MD2PDF Studio**
- Created by: Yuvrender Gill
- Organization: Xenova Labs
- Website: https://xenova.ai
- License: Free and open to the world

**Xenova Labs** (https://xenova.ai) is an AI research organization dedicated to building privacy-first tools. MD2PDF Studio is donated to the world for free as a public good.

---

*MD2PDF Studio - A free gift to the world from Xenova Labs (https://xenova.ai)*
*Privacy-first. Zero data retention. Free forever.*