笔记本样式 markdown 扩展

如果您使用过 Jupyter 笔记本，您会记得它们在标记中有输入和输出的概念，输入是您输入的内容，输出是编译器或解释器返回的内容（对于基于表达式的语言如 OCaml 或 Haskell 非常有用）。

当在 Pelican 的 Jupyter Notebook 扩展中工作时，我发现尝试将输入和输出转换为 markdown 语法存在问题，因此我认为在 markdown 中表示它们可能很有用。

此扩展添加了对元素 |[]> 和 |<[] 的支持，分别表示 输出 和 输入。它们将被渲染在带有定义类样式的 code 元素内，例如

|[]> val a: int = 4 |[]>

将被渲染为

<code class="notebook_output">val a: int = 4</code>

您可以在括号内定义一个数字来设置样式

|[12]> val a: int = 5 |[]>

将被渲染为

<span class="notebook_output_index">12</span><code class="notebook_output">val a: int = 4</code>

配置选项

• output_class 使用输出代码的类，默认为 notebook_output
• show_output 显示输出，默认为 True，如果您想完全隐藏输出，请设置此选项。
• show_label 为输出显示标签。
• label_text 与 show_label 结合使用，为每个输出设置标签文本。

使用扩展

首先使用 pip 安装： pip install markdown-notebook，然后在您的 Python Markdown 库中设置扩展名称，扩展名称为 mdx_notebook。