Documentation
Edit on GitHubComplete documentation for the OfficeIMO suite of .NET libraries for creating and manipulating Office documents.
Use guides for workflow decisions, then drop into API pages when you need type-level detail
The docs landing page is meant to answer which package or workflow you should use. Start with getting started if you are new to the suite, or jump straight into the guide family that matches the document format you need to generate, convert, or automate.
Get productive before you choose a deeper guide
These pages answer install, first-run, framework, platform, and package-selection questions for the whole OfficeIMO family.
Installation
NuGet and GalleryInstall the right .NET package or the PSWriteOffice module, and understand how the suite is split across focused libraries.
Use this first if you are deciding what to install for a new project.
Quick Start
First fileGenerate a real document quickly and use working starter examples to orient yourself before diving into larger workflows.
Use this when you want a short path from install to a successful output file.
Platform Support
Targets and AOTConfirm framework support, cross-platform expectations, and trimming or AOT guidance before you commit to a deployment model.
Use this when you are validating runtime, OS, or publish constraints.
Choose the document workflow you want to build
Each guide family starts with an overview page, then moves into focused pages for the most common authoring patterns in that package.
Word Documents
AuthoringParagraphs, tables, images, bookmarks, headers, footers, and document structure for `.docx` generation and editing.
Best for: reports, templated documents, generated letters, and rich Word layouts.
Excel Workbooks
ReportingWorksheets, tables, ranges, formulas, validation, and chart-driven spreadsheet workflows.
Best for: exports, operational reporting, and workbook generation from application data.
PowerPoint Presentations
SlidesSlide composition, shapes, text, images, charts, and repeatable deck assembly patterns.
Best for: generated status decks, slide automation, and presentation pipelines.
Markdown
Builder and ASTFluent markdown building, parser and AST concepts, HTML rendering, and content-pipeline patterns.
Best for: markdown generation, parsing pipelines, renderer hosts, and structured text workflows.
CSV
Schemas and streamingTyped CSV models, validation, schema control, headers, and stream-oriented import and export workflows.
Best for: stable CSV pipelines where structure and validation matter as much as data values.
Visio Diagrams
Shapes and connectorsPages, shapes, connectors, and diagram authoring patterns for generated `.vsdx` output.
Best for: generated diagrams, process maps, and documentation visuals.
Reader and Extraction
IngestionUnified extraction, chunking, normalization, and ingestion-oriented workflows across document inputs.
Best for: search indexing, content ingestion, and AI-oriented preprocessing stages.
Use higher-level workflows when C# package docs are not the whole story
These guides focus on PowerShell automation, document conversion, and deployment details that span more than one package.
PSWriteOffice
PowerShellCmdlets and DSL-oriented automation for Word, Excel, PowerPoint, Markdown, and CSV workflows.
Best for: scheduled reporting, GitHub Actions, and script-first document generation.
Word to HTML
ConverterBidirectional conversion between Word documents and HTML using the conversion package family.
Best for: publishing, sanitizing, or round-tripping document content to web formats.
Word to Markdown
ConverterConvert between Word and Markdown when your workflow crosses repository docs and generated Office output.
Best for: documentation pipelines, content migration, and markdown-centric exports.
OfficeIMO is an open-source, cross-platform suite of .NET libraries for creating and manipulating Office document formats without requiring Office to be installed. Built on top of the Open XML SDK and related package-specific components, OfficeIMO provides focused APIs for Word, Excel, PowerPoint, Markdown, CSV, and adjacent conversion workflows.
Package Feeds
| Package | Package Feed | Description |
|---|---|---|
| OfficeIMO.Word | OfficeIMO.Word on NuGet | Create, read, and modify Word (.docx) documents |
| OfficeIMO.Excel | OfficeIMO.Excel on NuGet | Create, read, and modify Excel (.xlsx) workbooks |
| OfficeIMO.PowerPoint | OfficeIMO.PowerPoint on NuGet | Generate PowerPoint (.pptx) presentations with slides, charts, and layouts |
| OfficeIMO.Markdown | OfficeIMO.Markdown on NuGet | Fluent Markdown builder, reader/AST, and HTML renderer |
| OfficeIMO.CSV | OfficeIMO.CSV on NuGet | Strongly-typed CSV document model |
| OfficeIMO.Visio | OfficeIMO.Visio on NuGet | Create and modify Visio (.vsdx) diagrams with shapes and connectors |
| OfficeIMO.Reader | OfficeIMO.Reader on NuGet | Extract and chunk document content for indexing, search, and AI ingestion |
| OfficeIMO.Word.Html | OfficeIMO.Word.Html on NuGet | Convert Word documents to/from HTML |
| OfficeIMO.Word.Markdown | OfficeIMO.Word.Markdown on NuGet | Convert Word documents to/from Markdown |
| PSWriteOffice | PSWriteOffice on PowerShell Gallery | PowerShell module wrapping OfficeIMO for Word, Excel, PowerPoint, and Markdown |
Quick Links
- Installation -- Install any OfficeIMO package via NuGet or PowerShell Gallery.
- Quick Start -- Create your first document in under five minutes.
- Platform Support -- Supported frameworks, operating systems, and AOT notes.
By Document Type
- Word Documents -- Paragraphs, tables, images, headers/footers, charts, bookmarks, and more.
- Excel Workbooks -- Worksheets, cell formatting, tables, conditional formatting, and charts.
- PowerPoint Presentations -- Slides, text boxes, shapes, and images.
- Markdown -- Fluent builder, typed AST reader, and HTML rendering pipeline.
- CSV -- Typed read/write workflows with validation and streaming.
- Visio Diagrams -- Pages, shapes, connectors, and diagram generation patterns.
- Reader & Extraction -- Unified extraction, chunking, and ingestion workflows.
Converters
- Word to HTML -- Bidirectional conversion between Word and HTML using AngleSharp.
- Word to Markdown -- Bidirectional conversion between Word and Markdown.
PowerShell
- PSWriteOffice Docs -- PowerShell cmdlets for Office document and Markdown automation.
- PowerPoint Cmdlets -- Build slide decks with cmdlets and DSL aliases.
- Markdown Cmdlets -- Generate Markdown reports, READMEs, and automation output.
Advanced
- AOT and Trimming -- Guidance for ahead-of-time compilation and IL trimming.
License
OfficeIMO is licensed under the MIT License . Copyright (c) Przemyslaw Klys @ Evotec. If you need to review upstream runtime dependencies such as Open XML SDK, ImageSharp, or QuestPDF, see the Third-Party Dependencies page.
Source Code
The full source code is available on GitHub: https://github.com/EvotecIT/OfficeIMO