diff --git a/modules/docs/src/Volo.Docs.Web/Markdown/MarkdownDocumentToHtmlConverter.cs b/modules/docs/src/Volo.Docs.Web/Markdown/MarkdownDocumentToHtmlConverter.cs
index 04049ea058..61ba5cdfd9 100644
--- a/modules/docs/src/Volo.Docs.Web/Markdown/MarkdownDocumentToHtmlConverter.cs
+++ b/modules/docs/src/Volo.Docs.Web/Markdown/MarkdownDocumentToHtmlConverter.cs
@@ -1,5 +1,6 @@
 using System;
 using System.Collections.Generic;
+using System.IO;
 using System.Net;
 using System.Text.RegularExpressions;
 using Microsoft.AspNetCore.Routing;
@@ -96,8 +97,12 @@ namespace Volo.Docs.Markdown
                 }
                 
                 var documentName = RemoveFileExtension(linkPart);
+                
+                var isFolder = !Path.HasExtension(linkPart);
+                
+                var isMdFile = linkPart.EndsWith(".md");
 
-                if (UrlHelper.IsExternalLink(link) || !linkPart.EndsWith(".md"))
+                if (UrlHelper.IsExternalLink(link) || !(isMdFile || isFolder))
                 {
                     return NormalizeLink(displayText, MdLinkFormat, link, projectShortName,
                         version,