DocxToPdfRenderer 1.2.2

DocxToPdfRenderer

A high-performance .NET 8.0 library for converting DOCX files to PDF format with precise table rendering, advanced text formatting, and built-in security validation. Designed for memory-based operations ideal for web services and cloud functions.

Features

• Precise Table Rendering: Accurate size calculations with improved unit conversion (v1.2.0)
• Advanced Text Formatting: Strikethrough, underline variants, superscript/subscript, small caps
• Memory-First API: Primary byte[] → byte[] conversion without file system dependencies
• Async/Await Support: Full async API with cancellation token support
• Security Validation: Built-in protection against malicious content and zip bombs
• Dependency Injection: Modular architecture with service interfaces
• Complex Documents: Headers, footers, tables, images, and mixed-run formatting
• Cross-Platform: Windows, Linux, and macOS support

Installation

dotnet add package DocxToPdfRenderer

Requires .NET 8.0 or later.

Quick Start

Basic Usage

using DocxToPdfRenderer;

var converter = new DocxToPdfRenderer();
byte[] pdfBytes = converter.ConvertDocxToPdf(docxBytes);

// Async with cancellation
byte[] pdfBytes = await converter.ConvertDocxToPdfAsync(docxBytes, cancellationToken);

// File conversion
converter.ConvertDocxToPdf("input.docx", "output.pdf");

ASP.NET Core Integration

// Program.cs
builder.Services.AddSingleton<IDocumentConversionService>(sp => {
    var logger = sp.GetRequiredService<ILogger<DocumentConversionService>>();
    return new DocumentConversionService(
        new ParserFactory(), new PdfDocumentComposer(), 
        new DefaultSecurityValidator(), logger);
});

// API endpoint
app.MapPost("/convert", async (HttpRequest req, IDocumentConversionService svc, CancellationToken ct) => {
    using var ms = new MemoryStream();
    await req.Body.CopyToAsync(ms, ct);
    var pdf = await svc.ConvertDocxToPdfAsync(ms.ToArray(), ct);
    return Results.File(pdf, "application/pdf", "converted.pdf");
}).DisableAntiforgery();

Configuration

using DocxToPdfRenderer.Core.Security;

// Security options
var securityOptions = new SecurityOptions
{
    MaxFileSize = 104857600,        // 100MB
    MaxUncompressedSize = 524288000, // 500MB
    ProcessingTimeout = 60000,       // 60 seconds
    MaxCompressionRatio = 100.0,     // Zip bomb protection
    StrictXmlValidation = true
};

var securityValidator = new DefaultSecurityValidator(securityOptions);
var conversionService = new DocumentConversionService(
    new ParserFactory(), 
    new PdfDocumentComposer(), 
    securityValidator, 
    logger);

Supported Features

Document Structure

• ✅ Paragraphs with mixed-run formatting
• ✅ Headers, footers, and page numbering
• ✅ Tables with precise size calculations (v1.2.0)
• ✅ Images (JPEG, PNG, BMP, GIF)
• ✅ Lists (numbered and bulleted)
• ✅ Page breaks and multi-page documents

Text Formatting

• ✅ Font family, size, colors
• ✅ Bold, italic, strikethrough (single/double)
• ✅ Underline variants (dotted, dashed, wavy, etc.)
• ✅ Superscript/subscript with baseline adjustments
• ✅ Small caps, all caps, text highlighting
• ✅ Character spacing and justification
• ✅ Text alignment (left, right, center, justify)

Table Features (Enhanced v1.2.0)

• ✅ Accurate width calculations (fixed, percentage, auto)
• ✅ Cell merging and complex structures
• ✅ Borders and shading
• ✅ Intelligent scaling to fit page width

Limitations

• ❌ Form fields, macros, comments
• ❌ Embedded objects (Excel, PowerPoint)
• ❌ Text effects (shadow, outline, emboss)
• ❌ Complex script support (RTL languages)

Security & Performance

Security Features

• Input validation with file size limits (default 50MB)
• Zip bomb protection with compression ratio limits
• Format validation to verify DOCX structure
• Timeout support with cancellation tokens
• Safe error handling without information leakage

Performance Tips

• Use async methods for web applications
• Configure appropriate file size limits
• Consider memory usage for large documents
• Implement rate limiting for API endpoints

What's New in v1.2.0

• Enhanced Table Rendering: Precise size calculations with improved unit conversion
• Better Layout Engine: Intelligent scaling and page layout calculations
• Advanced Text Support: Extended formatting options and mixed-run handling
• Improved Architecture: Cleaner separation with utility classes
• Better Logging: Comprehensive debug information for troubleshooting

Building from Source

git clone https://github.com/Vladimir-Cherepanov/DocxToPdfRenderer.git
cd DocxToPdfRenderer
dotnet restore
dotnet build
dotnet test

Dependencies

• DocumentFormat.OpenXml - Microsoft's DOCX SDK
• PdfSharpCore - Cross-platform PDF generation
• SixLabors.ImageSharp - Image processing
• Microsoft.Extensions.Logging - Structured logging

Contributing

Contributions are welcome! Please:

1. Fork and create a feature branch
2. Follow C# coding conventions
3. Add tests for new features
4. Submit a pull request

License

MIT License. See LICENSE file for details.