Сделано расширение Markdig для включения дополнительных файлов Markdown.

Author: Cregennan

MarkdigExtensions/AutoInclude/AutoIncludeBlock.cs

@@ -0,0 +1,17 @@
+using Markdig.Helpers;
+using Markdig.Parsers;
+using Markdig.Syntax;
+
+namespace Markus.MarkdigExtensions.AutoInclude
+{
+    internal class AutoIncludeBlock : LeafBlock
+    {
+        public AutoIncludeBlock(BlockParser? parser) : base(parser)
+        {
+            ProcessInlines = false;
+        }
+
+        public StringSlice Filename { get; init; }
+        
+    }
+}

MarkdigExtensions/AutoInclude/AutoIncludeParser.cs

@@ -0,0 +1,106 @@
+using Markdig.Helpers;
+using Markdig.Parsers;
+using Markdig.Parsers.Inlines;
+using Markdig.Syntax.Inlines;
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace Markus.MarkdigExtensions.AutoInclude
+{
+    internal class AutoIncludeParser : BlockParser
+    {
+
+        private readonly string _openingSequence = "@@[[";
+        private readonly string _closingSequence = "]]";
+
+        private readonly char _openingCharacter = '@';
+        private readonly char _firstClosingCharacter = ']';
+
+        public AutoIncludeParser() {
+
+            OpeningCharacters = new[] { _openingCharacter };
+        }
+
+        public override BlockState TryOpen(BlockProcessor processor)
+        {
+            if (processor.IsCodeIndent)
+            {
+                return BlockState.None;
+            }
+            
+            var sourceColumn = processor.Column;
+            var line = processor.Line;
+            var sourcePosition = line.Start;
+            var c = processor.NextChar();
+
+            int index = 1;
+
+
+            while(c != '\0' && index < _openingSequence.Length)
+            {
+                if (c != _openingSequence[index])
+                {
+                    processor.Column = sourceColumn;
+                    processor.Line = line;
+                    return BlockState.None;
+                }
+                index++;
+                c = processor.NextChar();
+            }
+            
+            //Exit if invalid opening sequence
+            if (index != _openingSequence.Length)
+            {
+                processor.Column = sourceColumn;
+                processor.Line = line;
+                return BlockState.None;
+            }
+
+            StringBuilder sb = new StringBuilder();
+
+            if (c != _firstClosingCharacter)
+            {
+                sb.Append(c);
+                while (c != _firstClosingCharacter)
+                {
+                    c = processor.NextChar();
+                }
+            }
+            index = 0;
+
+            while(c != '\0' && index < _closingSequence.Length)
+            {
+                if (c != _closingSequence[index])
+                {
+                    processor.Column = sourceColumn;
+                    processor.Line = line;
+                    return BlockState.None;
+                }
+                index++;
+                c = processor.NextChar();
+            }
+            if (index != _closingSequence.Length)
+            {
+                processor.Column = sourceColumn;
+                processor.Line = line;
+                return BlockState.None;
+            }
+
+            var autoIncludeBlock = new AutoIncludeBlock(this)
+            {
+                Column = sourceColumn,
+                Span = { Start = sourcePosition },
+                Filename = new StringSlice(sb.ToString())
+            };
+            processor.GoToColumn(sourceColumn + _openingSequence.Length + sb.Length + _closingSequence.Length + 1);
+            processor.NewBlocks.Push(autoIncludeBlock);
+
+            autoIncludeBlock.Span.End = processor.Line.End;
+
+            return BlockState.Break;
+        }
+    }
+}

MarkdigExtensions/ExtensionUsings.cs

@@ -0,0 +1,23 @@
+using Markdig;
+using Markus.MarkdigExtensions.AutoInclude;
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace Markus.MarkdigExtensions
+{
+    internal static class ExtensionUsings
+    {
+        public static MarkdownPipelineBuilder UseAutoInclude(this MarkdownPipelineBuilder builder)
+        {
+            if (!builder.BlockParsers.Contains<AutoIncludeParser>())
+            {
+                builder.BlockParsers.Insert(0, new AutoIncludeParser());
+            }
+            return builder;
+        }
+
+    }
+}

Markus.csproj

@@ -48,10 +48,6 @@
     </Content>
   </ItemGroup>
 
-  <ItemGroup>
-    <Folder Include="MarkdigExtensions\" />
-  </ItemGroup>
-
   <ItemGroup>
     <None Update="Schemas\manifestSchema.json">
       <CopyToOutputDirectory>Never</CopyToOutputDirectory>

Services/MarkdownService.cs

@@ -4,6 +4,8 @@
 using Markdig;
 using Markdig.Syntax;
 using Markdig.Syntax.Inlines;
+using Markus.MarkdigExtensions;
+using Markus.MarkdigExtensions.AutoInclude;
 using Markus.Processing;
 using MarkTables = Markdig.Extensions.Tables;
 
@@ -29,6 +31,7 @@ static MarkdownService()
             Pipeline = new MarkdownPipelineBuilder()
                 .UseFootnotes()
                 .UseAdvancedExtensions()
+                .UseAutoInclude()
                 .Build();
 
         }
@@ -44,7 +47,7 @@ public static async Task<IEnumerable<MarkdownObject>> GetMarkdownTokens(string f
         {
 
             //This functionality is not implemented yet: recursive include_once like behaivor of markdown parser
-            if (recursive && processedPaths == null)
+            if (recursive && processedPaths is null)
             {
                 processedPaths = new HashSet<string>();
             }
@@ -64,7 +67,6 @@ public static void ProcessBlocks(IEnumerable<MarkdownObject> blocks, Wordprocess
 
             foreach (MarkdownObject block in blocks)
             {
-
                 switch (block)
                 {