Minor improvements to prepare for next release

Author: manfromarce

README.md

@@ -71,11 +71,11 @@ Forked:
 - [b2xtranslator](https://github.com/EvolutionJobs/b2xtranslator)
 - [markdig.docx](https://github.com/morincer/markdig.docx)
 
-Others (credits for parts of the logic):
+Others (credits for parts of the logic, not direct dependencies):
 - [Html2OpenXml](https://github.com/onizet/html2openxml) for images header decoding and unit conversions.  
 - [dwml_cs](https://github.com/m-x-d/dwml_cs) for Office Math (OMML) to LaTex conversion  
 - [addFormula2docx](https://github.com/Sun-ZhenXing/addFormula2docx) for Office Math (OMML) to MathML conversion  
-- [RtfPipe](https://github.com/erdomke/RtfPipe), [FridaysForks.RtfPipe](https://github.com/cezarypiatek/FridaysForks.RtfPipe), [RtfConverter](https://github.com/jokecamp/RtfConverter) for part of the RTF parsing logic.  
+- [RtfPipe](https://github.com/erdomke/RtfPipe) (and forks: [1](https://github.com/jasonwmeeks/RtfPipe), [2](https://github.com/cezarypiatek/FridaysForks.RtfPipe)), [RtfConverter](https://github.com/jokecamp/RtfConverter), [OpenRTFDoc](https://github.com/ChunbleBee/OpenRTFDoc), [ReasonableRTF.Standard](https://github.com/Flamifly/ReasonableRTF.Standard) for RTF parsing logic.  
 - [ExcelNumberFormat](https://github.com/andersnm/ExcelNumberFormat) for Excel format strings parsing logic.
 
 <a id="recommended_libraries"></a>

src/DocSharp.Docx/Formats/FileFormatHelpers.cs

@@ -34,6 +34,22 @@ public static ISaveOptions ToSaveOptions(this SaveFormat saveFormat)
         }
     }
 
+    public static LoadFormat ExtensionToLoadFormat(string ext)
+    {
+        switch (ext.ToUpperInvariant())
+        {
+            case ".DOCX":
+            case ".DOTX":
+            case ".DOCM":
+            case ".DOTM":
+                return LoadFormat.Docx;
+            case ".RTF":
+                return LoadFormat.Rtf;           
+            default:
+                throw new NotImplementedException("Unrecognized load format. Please specify the LoadFormat explicitly.");
+        }
+    }
+
     public static SaveFormat ExtensionToSaveFormat(string ext)
     {
         switch (ext.ToUpperInvariant())
@@ -66,7 +82,7 @@ public static SaveFormat ExtensionToSaveFormat(string ext)
             case ".TXT":
                 return SaveFormat.Txt;
             default:
-                throw new NotImplementedException("Unsupported save format.");
+                throw new NotImplementedException("Unrecognized save format. Please specify the SaveFormat explicitly.");
         }
     }
 

src/DocSharp.Docx/Formats/LoadFormat.cs

@@ -0,0 +1,13 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace DocSharp.Docx;
+
+public enum LoadFormat
+{
+    Docx,
+    Rtf
+}

src/DocSharp.Docx/Formats/SaveOptions.cs

@@ -10,15 +10,21 @@
 
 namespace DocSharp.Docx;
 
-public interface ISaveOptions { }
+public interface ISaveOptions
+{
+    SaveFormat Format { get; }
+}
 
 public class DocxSaveOptions : ISaveOptions
 {
+    public SaveFormat Format => SaveFormat.Docx;
     public WordprocessingDocumentType DocumentType { get; set; } = WordprocessingDocumentType.Document;
 }
 
 public class RtfSaveOptions : ISaveOptions
 {
+    public SaveFormat Format => SaveFormat.Rtf;
+
     /// <summary>
     /// Gets or set the default font and paragraph properties used in (rare) cases where 
     /// they are not specified in in neither the document body, styles or default style. 
@@ -49,6 +55,8 @@ public class RtfSaveOptions : ISaveOptions
 
 public class HtmlSaveOptions : ISaveOptions
 {
+    public SaveFormat Format => SaveFormat.Html;
+
     /// <summary>
     /// Image converter to preserve TIFF, EMF and other image types when converting to HTML. 
     /// If the DocSharp.ImageSharp or DocSharp.SystemDrawing package is installed, 
@@ -107,6 +115,8 @@ public class HtmlSaveOptions : ISaveOptions
 
 public class MarkdownSaveOptions : ISaveOptions
 {
+    public SaveFormat Format => SaveFormat.Markdown;
+
     /// <summary>
     /// If this property is set to a directory, images will be exported to that folder
     /// and a reference will be added in Markdown syntax,
@@ -165,6 +175,8 @@ public class MarkdownSaveOptions : ISaveOptions
 
 public class TxtSaveOptions : ISaveOptions
 {
+    public SaveFormat Format => SaveFormat.Txt;
+
     /// <summary>
     /// Since plain text is not paginated, only the header of the first section and
     /// footer of the last section are exported.
@@ -183,4 +195,4 @@ public class TxtSaveOptions : ISaveOptions
     /// If null or empty, sub-documents will not be preserved.
     /// </summary>
     public string? OriginalFolderPath { get; set; }
-}
+}

src/DocSharp.Markdown/MarkdownConverter.cs

@@ -300,7 +300,49 @@ public string ToRtfString(MarkdownSource markdown, MarkdownToRtfSettings? settin
         RenderToRtf(markdown.Document, rtfBuilder, settings);
         return rtfBuilder.ToString();
     }
-    
+
+    /// <summary>
+    /// Convert Markdown to HTML and save to file.
+    /// </summary>
+    /// <param name="markdown">The markdown source.</param>
+    /// <param name="outputFilePath">The output HTML file path.</param>
+    public void ToHtml(MarkdownSource markdown, string outputFilePath)
+    {
+        using (var sw = new StreamWriter(outputFilePath, append: false, encoding: Encodings.UTF8NoBOM))
+            ToHtml(markdown, sw);
+    }
+
+    /// <summary>
+    /// Convert Markdown to HTML and save to a Stream.
+    /// </summary>
+    /// <param name="markdown">The markdown source.</param>
+    /// <param name="outputStream">The output HTML stream.</param>
+    public void ToHtml(MarkdownSource markdown, Stream outputStream)
+    {
+        using (var sw = new StreamWriter(outputStream, encoding: Encodings.UTF8NoBOM, bufferSize: 1024, leaveOpen: true))
+            ToHtml(markdown, sw);
+    }
+
+    /// <summary>
+    /// Convert Markdown to HTML and write to a TextWriter.
+    /// </summary>
+    /// <param name="markdown">The markdown source.</param>
+    /// <param name="output">The output writer.</param>
+    public void ToHtml(MarkdownSource markdown, TextWriter output)
+    {
+        markdown.Document.ToHtml(output, MarkdownSource.DefaultPipeline);
+    }
+
+    /// <summary>
+    /// Convert Markdown to HTML and returns a string.
+    /// </summary>
+    /// <param name="markdown">The markdown source.</param>
+    /// <returns>The HTML document as <see cref="string"/></returns>
+    public string ToHtmlString(MarkdownSource markdown)
+    {
+        return markdown.Document.ToHtml(MarkdownSource.DefaultPipeline);
+    }
+
     private void RenderToRtf(MarkdownDocument document, RtfStringWriter rtfBuilder, MarkdownToRtfSettings settings)
     {
         var renderer = new RtfRenderer(rtfBuilder, settings)

src/DocSharp.Markdown/MarkdownSource.cs

@@ -58,16 +58,18 @@ public static MarkdownSource FromStream(Stream stream, Encoding? encoding = null
         }
     }
 
+    internal static readonly MarkdownPipeline DefaultPipeline = new MarkdownPipelineBuilder()
+                                                                        .UseAdvancedExtensions()
+                                                                        .UseEmojiAndSmiley()
+                                                                        .Build();
+
     /// <summary>
     /// Create a Markdown source from a Markdown string
     /// </summary>
     /// <param name="markdown">The Markdown content as string</param>
     public static MarkdownSource FromMarkdownString(string markdown)
     {
-        var pipeline = new MarkdownPipelineBuilder().UseAdvancedExtensions()
-                                                    .UseEmojiAndSmiley()
-                                                    .Build();
-        return Markdig.Markdown.Parse(markdown, pipeline);
+        return Markdig.Markdown.Parse(markdown, DefaultPipeline);
     }
 
     /// <summary>

src/WIP/DocSharp.Renderer/DocSharp.Renderer.csproj

@@ -18,7 +18,7 @@
   </PropertyGroup>
 
   <ItemGroup>
-    <PackageReference Include="QuestPDF" Version="2025.12.2" />
+    <PackageReference Include="QuestPDF" Version="2025.12.3" />
 
     <PackageReference Include="CSharpMath.Rendering" Version="0.5.1" />
     <!-- <PackageReference Include="CSharpMath.SkiaSharp" Version="0.5.1" /> -->