在 ASP.Net Core 网站中使用 Microsoft 文档答案

【问题标题】：Using Microsoft docs inside an ASP.Net Core website在 ASP.Net Core 网站中使用 Microsoft 文档
【发布时间】：2021-01-23 08:32:20
【问题描述】：

Microsoft 的现代文档网站主要由托管在 GitHub 上的 Markdown 文件生成。通常，文档会在右侧显示左侧窗格导航菜单和文档导航部分。这是一个例子：

Microsoft 还生成一组tools to help documentation authors 和VS Code 的相关扩展。

是否可以使用它在您自己的网站中托管 Microsoft 文档？如果是这样，是否有任何在 ASP.Net Core 网站中执行此操作的示例？

【问题讨论】：

【解决方案1】：

您可能想查看一位从事 Docs 工作的 Microsoft 员工的 this blog 帖子，其中描述了如何设置和使用 Microsoft Docs 所基于的 DocFX。

~~另外，GitHub issue 很好地总结了当前状态。~~（链接存储库中的所有问题都已删除。）

除此之外，您提到的链接对应于this Visual Studio Code 扩展包，您可能尤其在Docs Preview 中。它将有助于编写和预览 Docs Markdown 风格的语法。

虽然存储库链接回包 GitHub 页面，但 Docs Preview 的源代码似乎不可用，而且许可证根本不允许，只授予 Microsoft 权利，但不授予您任何回报。即使您可以手动查看下载的扩展程序的代码，也不会授予您在任何商业项目中使用任何获得的代码或知识的任何权限。

【讨论】：

【解决方案2】：

我认为您想实现显示文本编辑器的功能，用户可以在其中输入 Markdown 文本并希望显示该 Markdown 的预览。

为此，您可以使用来自 Nuget 的 MarkDig 或 CommonMark 包

【讨论】：