在 Engee 中使用 Markdown

Markdown 是一种轻量级标记语言，设计用于编写结构化文本，在 Engee 中用于标记。它可用于注释、脚本编辑器文本单元格、.md 文件以及 Engee 中任何可使用 Markdown 编写文本的地方。 Engee*使用扩展的Markdown方言，除标准元素外，还支持常规标记中不存在的扩展元素（详见*Engee）。扩展语法).

在脚本编辑器文本格式的工具栏中，标准 Markdown 元素与扩展元素之间有垂直分隔线：

script editor text x

基本语法

让我们来看看 Markdown 语言的基本语法：

标题

标题 - 使用表示一级标题（最大的标题）。使用表示二级标题，依此类推，直至第六级：

# Заголовок первого уровня

## Заголовок второго уровня

...

###### Заголовок шестого уровня

文本选择_

文本选择* - 使用 * 或 _ 可以斜体显示文本。使用 * * * 或 _ _ 粗体显示文本。使用 ~ ~ ~ 来删除文本。

*Курсивный текст*

**Полужирный текст**

~~Зачеркнутый текст~~

列表。

列表 - 使用 *、- 或 + 创建无序列表。使用带点的数字创建有序列表。

* Пункт списка 1
* Пункт списка 2

1. Пункт списка 1
2. Пункт списка 2

公式

在 Engee 改用 KaTeX 之后，带有不含 $ 或 $&dollar;$ 的 LaTeX 公式的旧脚本可能无法正确显示。请确保所有公式都用 $ 或 $&dollar;$ 包装，如有必要，请删除可能自动添加的任何额外转义字符 (\)。

欲了解更多信息和实现更复杂的语法，请参阅.KaTeX官方文档。

Markdown Engee 默认支持使用KaTeX 库显示 LaTeX 公式。

要正确显示公式，请用 $ 将公式包起来：

$…$ - 用于单行公式，例如：

 $x = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}$

$&dollar;…$&dollar; - 用于多行公式，例如： $&dollar;…$&dollar; ：

 $\frac{1}{\sigma \sqrt{2\pi}} \\ \cdot \exp\left( -\frac{(x - \mu)^2}{2\sigma^2} \right)$

引言

引号 - 使用 > 创建引号。

> Ваша цитата.

代码

Code - 使用向后的撇号（回车键）""对文本进行包装，以插入单行代码。使用三个向后的撇号（ ` ` ` ` ）插入多行代码。

Пример `кода` внутри текста.

```
Многострочный
код
```

链接。

链接 - 使用"[链接文本](URL) "结构创建超链接。

[Документация Engee](https://engee.com/helpcenter/stable/)

图片

Images - 使用标准结构`![备选文本](图像 URL)` 插入图像。例如

![Логотип](https://astralinux.ru/upload/iblock/ef6/398hnxlwiur3hci7uozjn9n9wagwp1n6.png)

如果需要控制图片的对齐方式和大小，可以使用 HTML 或 CSS。以下是不同选项的示例：

选项代码^. 对齐类型

选项代码^.	对齐类型
`![Engee](https://engee.com/helpcenter/stable/_next/static/media/engee.png){width=100px}`	默认值
`<p align="left"> <img width="100px" src="https://engee.com/helpcenter/stable/_next/static/media/engee.png"> </p>`	左边缘
`<p align="center"> <img width="100px" src="https://engee.com/helpcenter/stable/_next/static/media/engee.png"> </p>`	在中心
`<p align="right"> <img width="100px" src="https://engee.com/helpcenter/stable/_next/static/media/engee.png"> </p>`	右边缘
`<center> <img src="https://engee.com/helpcenter/stable/_next/static/media/engee.png" style="max-width: 100px;"> </center>`	以 `<center> 为中心
`![Engee](attachment:engee.png){.center style="display: block; margin: 0 auto; width: 100px;"}`	通过".centre "居中

![Engee](https://engee.com/helpcenter/stable/_next/static/media/engee.png){width=100px}

默认值

<p align="left">
  <img width="100px" src="https://engee.com/helpcenter/stable/_next/static/media/engee.png">
</p>

左边缘

<p align="center">
  <img width="100px" src="https://engee.com/helpcenter/stable/_next/static/media/engee.png">
</p>

在中心

<p align="right">
  <img width="100px" src="https://engee.com/helpcenter/stable/_next/static/media/engee.png">
</p>

右边缘

<center>
  <img src="https://engee.com/helpcenter/stable/_next/static/media/engee.png"
       style="max-width: 100px;">
</center>

以 `<center> 为中心

![Engee](attachment:engee.png){.center style="display: block; margin: 0 auto; width: 100px;"}

通过".centre "居中

markdown all images example

如果通过`attachment:filename.png`使用本地图片，它们也支持 CSS 样式，如表格中的最后一个示例。

attachment:`是对附加到脚本编辑器的本地文件的特殊引用。交互式脚本格式 ngscript 和 ipynb 支持插入此类图片。要以 attachment: 的形式添加图像，只需将文件（例如 engee.png）从 *Engee*文件浏览器拖放到脚本编辑器单元格中，它就会自动以 ![engee.png](attachment:engee.png) 的形式出现，并在预览中可见。

分隔符.

水平破折号 - 使用三个连字符 - - - - 或三个星号 * * * * 插入水平破折号。

---
***

表格。

Tables - 使用 | 和 - 创建表格。

| Заголовок 1 | Заголовок2 |
| ----------- | ----------- |
| Ячейка 1 | Ячейка 2 |
| Ячейка 3 | Ячейка 4 |

或 WYSIWYG 中提供的替代语法：

#|
||

Заголовок 1

|

Заголовок 2

||
||

Ячейка 1

|

Ячейка 2

||
||

Ячейка 3

|

Ячейка 4

||
|#

扩展语法

使用扩展标记时，务必缩进内容，留出空行：

正确

不正确

{% note info %}

Это примечание.

{% endnote %}

{% note info %}
Это примечание.
{% endnote %}

备注

注释* (note)是一个突出显示的块，可引起对其所含信息的注意。根据上下文，您可以使用关键字 info、tip、warning 和 `alert`来使用不同类型的注释：

有关使用注释的更多信息。

类型用途举例说明

类型	用途	举例说明
`info` （注）	附加信息。	[源文件，markdown]。 {% note info %} Это примечание. {% endnote %}
`tip`（提示）。	实用小贴士。	{% note tip %} Это совет. {% endnote %}
警告（重要）	警告可能存在的问题。	{% note warning %} Это важная информация. {% endnote %}
`alert`（警告。）	限制或错误。	[source,markdown]. {% note alert %} Это предупреждение. {% endnote %}

info （注）

附加信息。

[源文件，markdown]。

{% note info %}

Это примечание.

{% endnote %}

info markup

tip（提示）。

实用小贴士。

{% note tip %}

Это совет.

{% endnote %}

tip markup

警告（重要）

警告可能存在的问题。

{% note warning %}

Это важная информация.

{% endnote %}

warning markup

alert（警告。）

限制或错误。

[source,markdown].

{% note alert %}

Это предупреждение.

{% endnote %}

alert markup

您还可以为备注设置自己的标题或不设置标题：

<!-- Заметка со своим заголовком -->
{% note info "Свой заголовок" %}

Это заметка со своим заголовком.

{% endnote %}

<!-- Заметка без заголовка -->
{% note info "" %}

Это заметка без заголовка.

{% endnote %}

admonition markup

Cuts (cut) - 用于隐藏部分内容。

了解更多有关大块的信息

例如，您可以隐藏附加信息或长代码块：

{% cut "Заголовок ката" %}

Контент, который отобразится по нажатию.

{% endcut %}

kat markup

Katy 默认不支持展开项目的功能。

标签 (tabs) - 用于在不同部分之间切换，不会使页面杂乱无章

关于标签的更多信息

让我们以创建多个标签页为例：

{% list tabs %}

- Название вкладки 1

  Текст вкладки 1.

- Название вкладки 2

  Текст вкладки 2.

{% endlist %}

tabs markup

您还可以使用 {selected} 属性设置默认打开所需的选项卡：

{% list tabs %}

- Название вкладки 1

  Текст вкладки 1.

- Название вкладки 2 {selected}

  Эта вкладки будет открыта по умолчанию.

{% endlist %}

可使用 group 属性同步标签页：

{% list tabs group=instructions %}

- Python

  About python

- Java

  About java

{% endlist %}

{% list tabs group=instructions %}

- Python

  Duplicate python content

- Java

  Duplicate java content

{% endlist %}

tabs markup 1

页面重新加载时，标签页的状态将被保留。

单选按钮 (tabs radio) - 工作方式类似于标签页，但外观类似于切换按钮。

有关单选按钮的更多信息_.

让我们来看一个创建单选按钮的示例：

{% list tabs radio %}

- Linux

  Инструкция для Linux

- Windows

  Инструкция для Windows

{% endlist %}

tabs radio 1

与标签页一样，您可以使用 {selected} 设置默认选定项目：

{% list tabs radio %}

- macOS

  Инструкция

- Windows {selected}

  Этот пункт будет открыт по умолчанию.

{% endlist %}

使用 Markdown，您可以将不同平台的视频嵌入到 Engee 中。具体方法如下

有关视频的更多信息_.

要从支持的视频托管服务中嵌入视频，请按照以下格式操作

@[название_хостинга](id_видео_или_ссылка_на_него)

要这样做

将托管名称替换为列表中的平台名称：yandex, rutube, vk, youtube, vimeo, vine, osf, prezi。

转到视频页面并找到嵌入代码（在标签 <iframe> 中），然后从 src 属性中复制链接（不带引号）：

<iframe src="https://vk.com/video_ext.php?oid=-207738372&id=456239060&hd=2&autoplay=1" width="853" height="480" allow="autoplay; encrypted-media; fullscreen; picture-in-picture; screen-wake-lock;" frameborder="0" allowfullscreen></iframe>

将 id_video_id_or_link_to_it 替换为 src 属性中的链接。

示例将显示 VK 的视频播放器：

@[vk](https://vk.com/video_ext.php?oid=-207738372&id=456239060&hd=2&autoplay=1)

videos markup 2

或者，如果您需要嵌入其他托管服务的视频，请使用以下格式：

@[](https://files.kpm-ritm.ru/Engee_firststeps.mp4)

videos markup 1

HTML 整合

Markdown Engee 支持使用标签进行基于文本的 HTML 标记。让我们来看看最常用的标记：

带有 HTML 标记的_Markdown_。

<strong> 或 <b> - 标记用于将文本加粗。<strong> 最好用于语义相关的情况，即文本确实重要。

<p>Этот текст выделен с помощью <strong>тега strong</strong>, а этот <b>тега b</b>.</p>

<em> 或 <i> - 标记用于斜体文本。与粗体标签一样，<em> 在语义相关的情况下更受欢迎。

<p>Этот текст выделен с помощью <em>тега em</em>, а этот <i>тега i</i>.</p>

<s> - 标记用于为文本添加删除线。

<p>Этот текст <s>зачеркнут</s>.</p>

<p> - 标记用于创建一段文字。段落通常上下缩进。
```
<p>Этот текст находится в абзаце.</p>
```

<h1> -<h6> - 标记用于创建不同级别的标题。标题有不同的大小，通常用于组织页面内容。

<h1>Заголовок уровня 1</h1>
<h2>Заголовок уровня 2</h2>
<h3>Заголовок уровня 3</h3>
<h4>Заголовок уровня 4</h4>
<h5>Заголовок уровня 5</h5>
<h6>Заголовок уровня 6</h6>

<ul>, <ol>, <li> - 标记用于创建无序 <ul> 和有序 <ol> 列表及其元素 <li>。

<ul>
  <li>Первый элемент неупорядоченного списка</li>
  <li>Второй элемент неупорядоченного списка</li>
</ul>

<ol>
  <li>Первый элемент упорядоченного списка</li>
  <li>Второй элемент упорядоченного списка</li>
</ol>

<img> - 标签用于在页面中插入图片。

<img src="https://astralinux.ru/upload/iblock/ef6/398hnxlwiur3hci7uozjn9n9wagwp1n6.png" alt="Логотип Engee">

<a> - 标签用于插入链接。

<a href="https://engee.com/helpcenter/stable/">Документация Engee</a>

在 Engee 中使用 Markdown

基本语法

扩展语法

备注

HTML 整合

实用链接