Mythosia.Documents.Hwp
1.0.2
dotnet add package Mythosia.Documents.Hwp --version 1.0.2
NuGet\Install-Package Mythosia.Documents.Hwp -Version 1.0.2
<PackageReference Include="Mythosia.Documents.Hwp" Version="1.0.2" />
<PackageVersion Include="Mythosia.Documents.Hwp" Version="1.0.2" />
<PackageReference Include="Mythosia.Documents.Hwp" />
paket add Mythosia.Documents.Hwp --version 1.0.2
#r "nuget: Mythosia.Documents.Hwp, 1.0.2"
#:package Mythosia.Documents.Hwp@1.0.2
#addin nuget:?package=Mythosia.Documents.Hwp&version=1.0.2
#tool nuget:?package=Mythosia.Documents.Hwp&version=1.0.2
Mythosia.Documents.Hwp
v1.0.2 — OpenMcdf 3.1.4 dependency floor for HWP container parsing. See the release notes.
HWP (Hangul Word Processor) document loader. Parses .hwp files into DoclingDocument structured models via HwpLibSharp. Provides section/paragraph text extraction with table support.
Installation
dotnet add package Mythosia.Documents.Hwp
Quick Start
using Mythosia.Documents.Hwp;
var loader = new HwpDocumentLoader();
IReadOnlyList<DoclingDocument> docs = await loader.LoadAsync("docs/report.hwp");
string markdown = docs[0].ToMarkdown();
With RAG Pipeline
var service = new AnthropicService(apiKey, httpClient)
.WithRag(rag => rag
.AddDocuments(new HwpDocumentLoader(), "docs/report.hwp")
);
// Or auto-select loader by extension:
var service = new AnthropicService(apiKey, httpClient)
.WithRag(rag => rag.AddDocument("docs/report.hwp"));
Table Rendering
HWP documents default to SemanticTableSerializer. Form-style tables (e.g., application forms, key-value layouts) are automatically detected and rendered with bold group labels (**label**) for improved RAG chunking context.
To override:
using Mythosia.Documents.Elements;
var docs = await loader.LoadAsync("docs/report.hwp");
docs[0].TableSerializer = new GridTableSerializer(); // switch to pipe table
Structured Extraction
The parser iterates HWP sections and paragraphs to produce a structured DoclingDocument:
- Headings — paragraphs with outline styles (Korean "개요" 1–9, Heading 1–9) are classified as headings.
- Titles — paragraphs with Korean "제목" or "Title" style are emitted as document titles.
- Tables — inline table controls are fully extracted with cell spans (ColSpan/RowSpan) preserved. Semantic form detection is applied by default.
- Paragraphs — all remaining text paragraphs are emitted as body paragraphs.
Parser Options
using Mythosia.Documents.Hwp;
var options = new HwpParserOptions
{
IncludeMetadata = true, // Extract section count metadata
NormalizeWhitespace = true, // Collapse excessive whitespace
IncludeSectionHeaders = false, // Emit section boundary headings
ExcludeControlChars = true, // Remove HWP control characters
};
var loader = new HwpDocumentLoader(options: options);
Custom Parser
Implement IDocumentParser and pass it to the loader:
var loader = new HwpDocumentLoader(parser: new MyCustomHwpParser());
Related Packages
| Package | Description |
|---|---|
| Mythosia.Documents.Abstractions | Core abstractions (DoclingDocument, IDocumentLoader) |
| Mythosia.Documents.Office | Word / Excel / PowerPoint loaders |
| Mythosia.Documents.Pdf | PDF loader |
| Mythosia.AI.Rag | RAG pipeline |
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 was computed. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 was computed. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
| .NET Core | netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
| .NET Standard | netstandard2.1 is compatible. |
| MonoAndroid | monoandroid was computed. |
| MonoMac | monomac was computed. |
| MonoTouch | monotouch was computed. |
| Tizen | tizen60 was computed. |
| Xamarin.iOS | xamarinios was computed. |
| Xamarin.Mac | xamarinmac was computed. |
| Xamarin.TVOS | xamarintvos was computed. |
| Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 2.1
- HwpLibSharp (>= 1.1.10.5)
- Mythosia.Documents.Abstractions (>= 1.2.0)
- OpenMcdf (>= 3.1.4)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
v1.0.2: Adds an explicit OpenMcdf 3.1.4 dependency floor in place of HwpLibSharp's vulnerable transitive floor and uses Mythosia.Documents.Abstractions 1.2.0. Public loader APIs are unchanged. Full notes: https://github.com/AJ-comp/Mythosia.AI/blob/main/src/loaders/Mythosia.Documents.Hwp/RELEASE_NOTES.md#v102