NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
NuGet
NuGet, #2354 most downloaded on NuGet
Lightweight, fast and simple .NET processing tool for importing, exporting and templating spreadsheets.
Latest stable
1.46.0
Last release 3 months ago
22 Aug 2026
Ships fairly regularly
a new release about every 5 weeks
Nearly every release is documented
notes for 57 of the last 60 stable releases
16 versions withdrawn
withdrawn after publishing
127 years old
130 releases · first in 1900
Drag across the ruler to compare, or tap a release to open it.
This release adds streaming XLSX/XLSM-to-Markdown conversion in two formats:
This release adds streaming XLSX/XLSM-to-Markdown conversion in two formats:
MarkdownFormat.Simple produces compact GitHub-Flavored Markdown tables.MarkdownFormat.LlmFriendly produces chunked Markdown with worksheet, range, row, column-address, and formula context for LLM and RAG workflows.It also adds a .NET 10 Blazor WebAssembly Browser Lab at https://mini-software.github.io/MiniExcel/ so workbooks can be converted locally in the browser, with a direct switch to the Rust WASM implementation.
Template rendering is also more reliable: formula cells and calcChain.xml are now regenerated correctly so Excel no longer rejects rendered workbooks containing static or $= formulas.
Download MiniExcel.1.46.0.nupkg or MiniExcel.1.46.0.snupkg from the Assets section below.
gh release download 1.46.0 \
--repo mini-software/MiniExcel \
--pattern "MiniExcel.1.46.0.*nupkg"
Install the downloaded package from the local directory:
dotnet add package MiniExcel --version 1.46.0 --source .
After publication to nuget.org, install normally with:
dotnet add package MiniExcel --version 1.46.0
Full Changelog: https://github.com/mini-software/MiniExcel/compare/1.45.0...1.46.0
Your coding agent can read these notes before it upgrades. Set up the MCP server →
1.46.0
Compare
This release adds .NET Framework 4.6.1 as an explicit target framework to the library. This was done because projects targeting the full framework wou
This release adds .NET Framework 4.6.1 as an explicit target framework to the library.
This was done because projects targeting the full framework would install through NuGet the closest matching version to their compilation target, said version being .NET 4.5 instead of the preferred netstandard2.0. This had the most notable effect of IAsyncEnumerables not being supported as exportable data sources.
Full Changelog: https://github.com/mini-software/MiniExcel/compare/1.44.1...1.45.0
This release is a hotfix for an oversight that prevented numerical string values to be recognized as text by Excel when explicitly exported with the "
This release is a hotfix for an oversight that prevented numerical string values to be recognized as text by Excel when explicitly exported with the "@" format.
Full Changelog: https://github.com/mini-software/MiniExcel/compare/1.44.0...1.44.1
This release addresses a long standing issue with regards to the MiniExcelFormatAttribute.
This release addresses a long standing issue with regards to the MiniExcelFormatAttribute.
Prior to this update all values of the properties it was used upon would be converted to their string representation according to the specified format, instead of being exported as is and linked to a style element like the OpenXml specification suggests. This prevented the results to be used as actual numerical values, e.g. in formulas, while still retaining their representation.
With this update the inconvenience has mostly been solved, as the following types will now be exported preserving their intended value:
int, long, double, decimal, etc...)DateTime, DateTimeOffset and DateOnlyTimeSpan and TimeOnlyFull Changelog: https://github.com/mini-software/MiniExcel/compare/1.43.1...1.44.0
Fixed headers being printed when using SaveAsAsync despite ExcelIgnore property set to true on DynamicExcelColumn by @michelebastione in https://githu
SaveAsAsync despite ExcelIgnore property set to true on DynamicExcelColumn by @michelebastione in https://github.com/mini-software/MiniExcel/pull/937Full Changelog: https://github.com/mini-software/MiniExcel/compare/1.43.0...1.43.1
This release brings the following features and fixes:
This release brings the following features and fixes:
RightToLeft parameter in OpenXmlConfiguration to make worksheets being displayed in a right-to-left layout when opened in Excel by @michelebastione in #935 (mirrors #927)ExcelHiddenAttribute that, when used to decorate a property, hides the mapped column in Excel by @michelebastione in #935 (mirrors #932)IAsyncEnumerator not being properly disposed in AsyncEnumerableWriteAdapter, leading to database connections not being released by @izanhzh and @michelebastione in #907 (mirrors #906)Dictionary or a DataTable by @michelebastione in #926 (mirrors #924)@group (like in some emails) to be mistakenly identified as template parameters by @michelebastione in #935 (mirrors #928)Full Changelog: https://github.com/mini-software/MiniExcel/compare/1.42.0...1.43.0
Added custom exception for indexers being treated as properties during serialization by @michelebastione in https://github.com/mini-software/MiniExcel
.net10.0 as a target framework to all projects and other related changes by @michelebastione in https://github.com/mini-software/MiniExcel/pull/899Full Changelog: https://github.com/mini-software/MiniExcel/compare/1.41.4...1.42
[Bug] Fixed issue where formulas were not being replaced in templates (#876) (via @michelebastione)
SaveAsByTemplate overload with Stream template parameter public and callable via API (#838) (via @michelebastione)[New] Adding QuoteWhitespaces option to CsvConfiguration for adding double quotes to string containing whitespaces #790 (via @michelebastione )
[New] Fixes enum behaviour and adds support for DescriptionAttribute when saving by template (via @michelebastione )
[New] Added sheet dimensions feature (#774) (via @michelebastione)
[New] MiniExcel AddPicture #770 (via @shps951023)
[New] Added support for DateOnly type in query mapping (via @michelebastione)
[New] Added exception to warn for sheet name too long (via @michelebastione)
[New] Added exception to warn for sheet name too long (via @michelebastione)
[New] Added options for trimming column names and ignoring empty rows (via @michelebastione)
[New] Added IAsyncDisposable calls to ExcelOpenXmlsheetWriter.Async (via @michelebastione)
[New] Add conditional formatting support to Excel template (#745) (via @Notallthatevil)
[New] Add support for .NET 9.0 in project file (#744) (via @Notallthatevil)
[Bug] Bugfix of invalid cell values being mistakenly parsed as valid (via @michelebastione)
[Bug] Changing NotImplementedException assert in some tests to NotSupportedException (via @michelebastione)
[Bug] Moved sheet name check and fixed datetime formatting bug (via @michelebastione)
[OPT] Optimize max memory usage of SaveAsByTemplate #750 (#752) (via @shps951023)
[OPT] Optimization of SaveAsTemplate method (#749) (via @michelebastione)
[OPT] Removing DateTimeHelper.FromOADate and related code (via @michelebastione)
[OPT] Remove redundant property in csproj file (#748) (via @AZhrZho)
[Breaking Change] QueryRange doesn't support column name without row number #763 (via @michelebastione)
[New] Added support for Uri mapping (#726) (via @michelebastione)
[New] feat(DynamicExcelColumn): make the CustomFormatter property more powerful (#715) (via @izanhzh)
[New] feat: support insert sheet (#709) (via @izanhzh)
[New] feat: support insert sheet (#709) (via @izanhzh)
[Bug] fix(MiniExcelDataReader): GetOrdinal always returns 0 (#711) (via @izanhzh)
[OPT] Generalize excel writing with a common write adapter and implement writing IAsyncEnumerable (#712) (via @Discolai , @izanhzh)
[New] feat(MiniExcelDataReaderBase): add asynchronous support (#706) (via @izanhzh , @ArgoZhang )
[New] Write auto column width (#695) (via @Discolai)
1.36.0
[New] Formula attribute added to support in rows with dto or dynamic attributes (#679) (via @RaZer0k & Co-authored-by: Eulises Vargas )
[New] Add MniExcelDataReaderBase class to simplify code (#651) (via @ArgoZhang )
[Bug] Fix Issue 632, refactor sheet styles (#640) (via @meld-cp)
[New] Add freeze panes (#626) (via @meld-cp)
[New] Support Template formulas (#622) (via @meld-cp)
ReadOnlySpan<byte> (via @shps951023)[New] .NET5^ support image ReadOnlySpan (via @shps951023)
[New] .NET5^ support image ReadOnlySpan<byte> (via @shps951023)
[Bug] Remove bug with Portable.System.DateTimeOnly and only support DateOnly .NET6^ #594 (via @shps951023)
[New] Using DynamicConfiguration when writing data using DataTable (via @pszybiak)
[Bug] DescriptionAttr null check(via @wulaoh)
[New] Support automatic merge for same vertical cells between @merge and @endmerge tags (via @eynarhaji)
[New] Support automatic merge for same vertical cells between @merge and @endmerge tags (via @eynarhaji)
[New] Limit merge tagged columns with @mergelimit column. First merge limited column and then merge other columns accordingly. (via @eynarhaji)
[New] Support dynamic columns when generating sheet by IDataReader to change columns names & widths #514 (via @Laxynium)
[Bug] Fix R1C1 reference to A1 reference bug (via @ivan132)
[New] Support Fields #490 (via @jsgervais)
/xl location error #494 (via @ArgoZhang)[New] support if/else statements inside cell (via @eynarhaji)
[New] support grouped rows (via @eynarhaji)
[New] support function to custom separator (via @hyzx86)
[New] support excel enum description string to enum #289 (via @KaneLeung)
1.30.0
### 1.29.0 - [New] SaveAs support FastMode - [Bug] Fixed SaveAs OOM problem
Nothing published for this version
Nothing published for this version
[New] Support Assembly Strong Name Signature #450
[Optimization] Reduce string memory allocation when template save #439 (via @cupsos)
[New] Support CSV Insert #I4X92G (via @shps951023)
[New] Support DateTimeOffset and ExcelFormat #430 (via @Lightczx , @shps951023 )
[New] Support DateTimeOffset and ExcelFormat #430 (via @Lightczx , @shps951023 )
[Optimization] SaveAs by datareader support dimension #231 (via @shps951023)
[OPT] Reduce memory allocation when using MemoryStream #427 (via @cupsos)
[OPT] Reduce memory allocation when using MemoryStream #427 (via @cupsos)
[OPT] Add System.Memory pacakge #427 (via @cupsos)
[OPT] Reduce memory allocation in GetImageFormat() #427 (via @cupsos)
[Bug] Fixed MiniExcel.SaveAsByTemplate error when value is List<Dictionary<string, object>> #413 (via @shps951023)
[OPT] Template save performance #425 (via @lileyzhao)
[New] Added DataReader AutoFilter toggle #402 #401 (via @Rollerss)
[Bug] Using stream.SaveAs will close the Stream automatically when Specifying excelType
1.26.4
[OPT] Export default buffersize from 1024 bytes -> 1024 * 512 bytes
1.26.3
[Bug] Fixed DynamicColumnAttribute Ignore, Index error #377
1.26.2
[New] DynamicColumnAttribute support Dictionary #370
1.26.1
[New] Support DynamicColumnAttribute (via @y976362357, @shps951023)
[New] Remove overdue ExcelNumberFormat Dependency #271
[Bug] Fixed QueryAsDataTable read big file will throw NotImplementedException #360
1.25.1
[New] Support SharingStrings disk cache (when this file size >= 5 MB), it can reduce reading 2GB SharingStrings only needs 1~13 MB memory #117(#346 vi
[Bug] Fixed multiple threads Async error 'The given key N was not present in the dictionary' #344
ff-Latn , datareader field type is datetime that will get error OA Date format #343[Bug] Fiexd Query multiple same title will cause startcell to get wrong column index #I4YCLQ
1.24.2
[Bug] Fiexd QueryAsync configulation not working #338
[New] Query support strict open xml, thanks Weilence (Lowell) #335
[New] Support System.ComponentModel.DisplayName's [DisplayName] as title [#I4TXGT]
[DisplayName] as title [#I4TXGT](https://gitee.com/dotnetchina/MiniExcel/issues/I4TXGT)Czech will get invalid output with decimal numbers #331Nothing published for this version
[New] Support GetReader method #328 #290 (Thanks [杨福来 Yang](https://github.com/yfl8910) )
GetReader method #328 #290 (Thanks [杨福来 Yang](https://github.com/yfl8910) )[Breaking Change] Remove Byte Array to base64 Converter
ConvertByteArrayToBase64String by EnableConvertByteArray[Bug] Fix SaveAs multiple sheet value error "Excel completed file level validation and repair. Some parts of this workbook may have been repaired or d
0.21.5
One column per quarter.