Changelog

All notable changes to the SyntaxDoc API will be documented here. We follow Semantic Versioning.

v2.0.0 - December 2024

Features

QR Code Generation

• Auto-generate QR codes directly in HTML using data-qr attributes
• Support for customizable size, error correction levels, and colors
• New endpoint: POST /pdf/qrcode for standalone QR code generation
• Perfect for certificates, tickets, and verification documents

<img data-qr="https://verify.example.com/cert-123" 
     data-qr-size="150" 
     data-qr-error-correction="H" />

Text Watermarks

• Add watermarks to all pages with full customization
• Configure text, font size, opacity, rotation, and color
• Multiple positioning options (diagonal, center, custom)
• Ideal for branding, security, and document status indication

{
  "watermark": {
    "text": "CONFIDENTIAL",
    "fontSize": 60,
    "opacity": 0.2,
    "rotation": -45,
    "position": "diagonal"
  }
}

Smart Page Breaks

• Automatic page break optimization for tables and content
• Intelligent table splitting with header repetition
• Orphan and widow prevention
• CSS classes: page-break-before, page-break-after, keep-together, no-page-break
• Data attributes: data-page-break, data-keep-together

Improvements

• Performance: 15% faster PDF generation for complex documents
• Memory: Reduced memory usage by 30% for batch operations
• Caching: Enhanced font and image caching mechanisms
• Error Handling: More descriptive error messages with actionable solutions

API Changes

• Added autoPageBreaks option (default: true) to enable/disable automatic optimization
• Added watermark configuration object to PDF options
• New QR code data attributes for inline generation

v1.5.2 - November 2024

Bug Fixes

• Fixed CSS Grid rendering issues in Safari-specific layouts
• Resolved memory leak in long-running batch operations
• Fixed font loading timeout errors for slow network connections
• Corrected page margin calculations for custom paper sizes

Improvements

• Added retry logic for failed hosted PDF uploads
• Improved error messages for API key validation
• Enhanced documentation with more code examples

v1.5.1 - October 2024

Features

• Added support for Legal and Tabloid paper formats
• New preferCSSPageSize option to use CSS @page rules

Bug Fixes

• Fixed background image rendering in complex nested layouts
• Resolved issue with SVG paths containing gradients
• Fixed header/footer overlap with page content

v1.5.0 - September 2024

Features

PDF Merging

• Merge multiple PDFs into a single document
• New endpoint: POST /pdf/merge
• Preserve document metadata and bookmarks
• Support for up to 100 PDFs per merge operation

Batch Processing Improvements

• Increased batch limit to 500 PDFs per request
• Parallel processing for faster batch generation
• Progress tracking for large batch operations

Improvements

• Better error recovery in batch operations - partial success handling
• Enhanced logging for debugging and monitoring
• Rate limit headers now include reset timestamp

v1.4.0 - August 2024

Features

• Added orientation option (portrait/landscape)
• Custom page dimensions with width and height options
• Support for custom margin units (cm, mm, in, px)

Improvements

• 25% faster image processing and embedding
• Better handling of large embedded images (>5MB)
• Improved CSS Flexbox support for complex layouts

Bug Fixes

• Fixed issue with nested CSS Grid containers
• Resolved color accuracy problems in CMYK color spaces
• Fixed edge case where fonts weren't loading from CDN

v1.3.0 - July 2024

Features

PDF Hosting

• Store PDFs in secure cloud storage
• Get shareable URLs instead of binary downloads
• Configurable retention periods (1-30 days)
• Automatic cleanup of expired PDFs

Improvements

• Added support for woff2 font format
• Enhanced table rendering for large datasets
• Better memory management for concurrent requests

v1.2.0 - June 2024

Features

• Added fileName option for custom PDF filenames
• Support for Google Fonts and Adobe Fonts
• Enhanced image optimization and compression

Bug Fixes

• Fixed rendering issues with CSS transform properties
• Resolved problems with nested absolute positioning
• Fixed character encoding issues in UTF-8 content

v1.1.0 - May 2024

Features

• Batch PDF Generation - Generate multiple PDFs as ZIP
• Support for custom page margins
• Added format option (A4, Letter, A3, A5)

Improvements

• Better error messages with specific error codes
• Enhanced API key management in dashboard
• Improved documentation with interactive examples

v1.0.0 - April 2024

Core Features

• HTML to PDF conversion with pixel-perfect accuracy
• Support for modern CSS (Flexbox, Grid, custom properties)
• Custom fonts with automatic web font loading
• Image embedding with intelligent caching
• Multi-page documents with automatic pagination
• API authentication with secure API keys
• Usage tracking and billing management
• Free tier - 100 conversions/month

Supported Endpoints

• POST /pdf/generate - Generate PDF from HTML
• GET /hosted-pdfs/:id - Retrieve hosted PDF

Future Roadmap

We're constantly improving SyntaxDoc. Here's what's coming next:

Planned for Q1 2025

• Digital Signatures - Add cryptographic signatures to PDFs
• Form Fields - Generate fillable PDF forms
• OCR Support - Extract text from scanned documents
• Template Management - Save and reuse HTML templates
• Webhooks v2 - Enhanced event tracking and filtering

Under Consideration

• PDF Editing - Modify existing PDFs (add pages, annotations)
• HTML to Image - Generate PNG/JPG from HTML
• Browser Automation - Take screenshots and interact with web pages
• Custom Headers/Footers - Dynamic content in headers/footers with variables

Release Notes Format

Each release includes:

• Version number following semantic versioning (MAJOR.MINOR.PATCH)
• Release date for tracking
• Features - New capabilities and endpoints
• Improvements - Performance enhancements and optimizations
• Bug Fixes - Issues resolved in this version
• API Changes - Breaking changes or deprecations
• Migration Guide - Steps to upgrade (when needed)

Stay Updated

Subscribe to our changelog:

• RSS Feed
• Email Newsletter
• Discord Community