编译自： https://opensource.com/article/18/8/markdown-html-publishing

作者： Peter Cheer

译者： geekpi

幻灯片html代码应用 MDwiki 将 Markdown 宣布成 HTML React

用这个有用工具从 Markdown 文件创建一个根本的网站。

有很多情由喜好 Markdown，这是一门大略的措辞，有易于学习的语法，它可以与任何文本编辑器一起利用。
利用像 Pandoc 这样的工具，你可以将 Markdown 文本转换为 各种盛行格式 ，包括 HTML。
你还可以在 Web 做事器中自动实行转换过程。
由 TimoDörr 创建的名为 MDwiki 的 HTML5 和 JavaScript 运用可以将一堆 Markdown 文件在浏览器要求它们时转换为网站。
MDwiki 网站包含一个操作指南和其他信息可帮助你入门：

Mdwiki 网站的样子。

在 Web 做事器内部，基本的 MDwiki 站点如下所示：

该站点的 web 做事器文件夹的样子

我将此项目的 MDwiki HTML 文件重命名为 START.HTML。
还有一个处理导航的 Markdown 文件和一个 JSON 文件来保存一些配置设置。
其他的都是网站内容。

虽然全体网站设计被 MDwiki 固定了，但内容、样式和页面数量却没有。
你可以在 MDwiki 站点 查看由 MDwiki 天生的一系列不同站点。
公正地说，MDwiki 网站缺少网页设计师可以实现的视觉吸引力 —— 但它们是功能性的，用户该当平衡其大略的外不雅观与创建和编辑它们的速率和大略单纯性。

Markdown 有不同的风格，可以针对不同的特定目的扩展稳定的核心功能。
MDwiki 利用 GitHub 风格 Markdown ，它为盛行的编程措辞添加了格式化代码块和语法高亮等功能，使其非常适宜天生程序文档和教程。

MDwiki 还支持 “gimmick”，它增加了如嵌入 YouTube 视频和显示数学公式等额外功能。
如果在某些项目中须要它们，这些值得探索。
我创造 MDwiki 是创建技能文档和教诲资源的空想工具。
我还创造了一些可能不会立即显现出来的技巧和 hack。

当支配在 Web 做事器中时，MDwiki 可与任何当代 Web 浏览器一起利用。
但是，如果你利用 Mozilla Firefox 访问 MDwiki，那么就不须要 Web 做事器。
大多数 MDwiki 用户会选择在 Web 做事器上支配完全的项目，以避免打消潜在用户，但只需利用文本编辑器和 Firefox 即可完成开拓和测试。
任何当代浏览器都可以读取加载到 Moodle 虚拟学习环境（VLE）中的完全的 MDwiki 项目，这在教诲环境中非常有用。
（对付其他 VLE 软件，这可能也是如此，但你该当测试它。
）

MDwiki 的默认配色方案并非适用于所有项目，但你可以将其更换为从 Bootswatch.com 下载的其他主题。
为此，只需在编辑器中打开 MDwiki HTML 文件，找到 extlib/css/bootstrap-3.0.0.min.css，然后插入下载的 Bootswatch 主题。
还有一个 MDwiki gimmick，让用户在浏览器中载入 MDwiki 后，选择 Bootswatch 主题来更换默认值。
我常常与有视力障碍的用户一起事情，他们方向于喜好高比拟度的主题，在深色背景上利用白色笔墨。

MDwiki 页面利用 Bootswatch Superhero 主题

MDwiki、Markdown 文件和静态图像可以用于许多目的。
但是，你有时可能希望包含 JavaScript 幻灯片或反馈表单。
Markdown 文件可以包含 HTML 代码，但将 Markdown 与 HTML 稠浊会让人感到困惑。
一种办理方案是在单独的 HTML 文件中创建所需的功能，并将其显示在带有 iframe 标记的 Markdown 文件中。
我从 Twine Cookbook 知道了这个想法，它是 Twine 交互式小说引擎的支持站点。
Twine Cookbook 实际上并没有利用 MDwiki，但结合 Markdown 和 iframe 标签开辟了广泛的创作可能性。

这是一个例子：

此 HTML 将显示由 Markdown 文件中的 Twine 交互式小说引擎创建的 HTML 页面。

<iframe height=\"大众400\"大众 src=\"大众sugarcube_dungeonmoving_example.html\公众 width=\"大众90%\"大众></iframe>

MDwiki 天生的站点结果如下所示：

简而言之，MDwiki 是一个出色的小运用，可以很好地实现其目的。

via: https://opensource.com/article/18/8/markdown-html-publishing

作者： Peter Cheer 选题： lujun9972 译者： geekpi 校正： wxy

本文由 LCTT 原创编译， Linux中国 名誉推出

点击“理解更多”可访问文内链接