用狮身人面像书写标记¶

为此，我们认识到MyST作为recommonmark的继任者的潜力，和反对后者而支持MyST-Parser.收件人开始在狮身人面像中写标记，您需要遵循三个步骤：

• 安装MyST分析器:pip（点阵） 安装 myst解析器

• 添加myst解析器Sphinx扩展列表：

扩展 = [
    # ...其他扩展
    “myst_parser”，
]

• 开始在中写入内容*.md文件文件夹！

您可以在中找到更多信息MyST-Parser文档.

会议上的会谈和研讨会¶

幸运的是，对大多数项目来说，迁移到MyST-Parser的过程很简单，但我们仍然想传播关于使用MyST Markdown在Read the Docs上创建Sphinx项目的最佳实践。我们设定了在每一次大型科学Python活动上展示的目标，我们所有的提议都被接受了1! 2021年全年，我们参加了多项活动：

• 我们进行了一次网络会议，并对文档进行了冲刺在SciPy美国，在那次活动中，我们受到了邀请这个sktime文档sprint.

• 我们提供了一个90分钟的教程，名为“用Markdown、Sphinx和Read the文档”在PyData Global，我们用西班牙语重复了120分钟的版本在SciPy拉丁美洲.

• 我们还在更广泛的活动中进行了简短的会谈：PyCon拉塔姆和西班牙PyCon.

我们制作了车间材料，欢迎大家使用：

• 一个主存储库包含一些关于狮身人面像的介绍性幻灯片，以及教程每个步骤的详细注释。

• 一个支持存储库有一个在教程中使用的小Python库，灵感来源于斯芬克斯官方教程我们在狮身人面像社区的帮助下创作。

最后，我们还开发了一个交互式web应用程序，用于将少量reStructuredText转换为MyST标记.

1

我们还提交了SciPy India的提案，延期至2022年1月。欧洲科学院和日本科学院在2021年没有举办。

未来计划¶

我们很高兴看到可执行图书团队已发布myst-docutils公司，这应该有助于docutils直接解析CommonMark并可能为斯芬克斯解析Markdown铺平道路无需第三方扩展。希望这也能让狮身人面像更容易在文档中更突出地展示降价内容，用户可以自然地选择标记语言最适合他们的需求，无论是reST还是MyST。

—

考虑在您的下一个狮身人面像、朱庇特书或MkDocs项目中使用Read the Docs？结账我们的文件开始吧！