【优快云】自带Markdown语法说明

Etincelle

已于 2024-11-10 05:20:34 修改

阅读量1.1k

点赞数 28

分类专栏：优快云 LaTeX Markdown 文章标签：学习

于 2024-11-09 11:18:30 首次发布

本文链接：https://blog.youkuaiyun.com/Etincelle/article/details/143641877

版权

LaTeX 同时被 3 个专栏收录

8 篇文章

订阅专栏

Markdown

8 篇文章

订阅专栏

优快云

4 篇文章

订阅专栏

换新设备登陆之后写文章不知道怎么弄出了这个，索性存个档，毕竟Markdown用到的时候还蛮多的。是优快云自带的语法说明，因为不知道原文链接所以标原创了。
二编：本来是自己存着备用的，但是看有人收藏了，才反应过来访客可能看不见具体代码，所以我整理了一下。 ` ` 内的高亮标红即为我补充的语法。
三编：不知道优快云哪里弄的语法文档，原版应该是英文的，因为这篇文档我细读了一下，一股子机翻味，有些地方甚至语义不通顺，稍微改了下。

@[TOC](这里写自定义目录标题)

欢迎使用Markdown编辑器

# 欢迎使用Markdown编辑器
标题语法大家应该很熟悉了，后面不再赘述。

你好！这是你第一次使用 Markdown编辑器 所展示的欢迎页。如果你想学习如何使用Markdown编辑器, 可以仔细阅读这篇文章，了解一下Markdown的基本语法知识。

新的改变

我们对Markdown编辑器进行了一些功能拓展与语法支持，除了标准的Markdown编辑器功能，我们增加了如下几点新功能，帮助你用它写博客：

全新的界面设计 ，将会带来全新的写作体验；
在创作中心设置你喜爱的代码高亮样式，Markdown 将代码片显示选择的高亮样式 进行展示；
增加了 图片拖拽 功能，你可以将本地的图片直接拖拽到编辑区域直接展示；
全新的 KaTeX数学公式 语法；
增加了支持甘特图的mermaid语法¹ 功能；
增加了 多屏幕编辑 Markdown文章功能；
增加了 焦点写作模式、预览模式、简洁写作模式、左右区域同步滚轮设置 等功能，功能按钮位于编辑区域与预览区域中间；
增加了 检查列表 功能。

此处有个注脚 [^1]: [mermaid语法说明](https://mermaidjs.github.io/)

功能快捷键

撤销：Ctrl/Command + Z
撤销：<kbd>Ctrl/Command</kbd> + <kbd>Z</kbd>
后面的类似按键e.g.都是形如 <kbd></kbd> 的格式。
重做：Ctrl/Command + Y
加粗：Ctrl/Command + B
斜体：Ctrl/Command + I
标题：Ctrl/Command + Shift + H
无序列表：Ctrl/Command + Shift + U
有序列表：Ctrl/Command + Shift + O
检查列表：Ctrl/Command + Shift + C
插入代码：Ctrl/Command + Shift + K
插入链接：Ctrl/Command + Shift + L
插入图片：Ctrl/Command + Shift + G
查找：Ctrl/Command + F
替换：Ctrl/Command + G

合理的创建标题，有助于目录的生成

直接输入1次#，并按下space后，将生成1级标题。
输入2次#，并按下space后，将生成2级标题。
以此类推，我们支持6级标题。有助于使用TOC语法后生成一个完美的目录。

如何改变文本的样式

强调文本 强调文本
*强调文本* _强调文本_

加粗文本 加粗文本
**加粗文本** __加粗文本__

标记文本
==标记文本==

~~删除文本~~
~~删除文本~~

引用文本
> 引用文本

H₂O 是液体。
H~2~O

2¹⁰ 运算结果是 1024.
2^10^

其实上下标特别是公式，推荐用LaTeX，也就是用$ $。
$\LaTeX$ 语法也不难，用两个$将公式框起来。例如， $2^{10}$ 显示为 $2^{10}$ 。写论文可能会用到，建议学习。

插入链接与图片

链接: link.
链接: [link](https://www.youkuaiyun.com/).
即: [你自己为链接取个名](链接).

图片: Alt
一般来说，直接复制过来就行了，没人会真敲图片的链接吧……复制过来后，会自动显示链接，这里不好展示，不清楚的试试就知道了。主要讲下面的改变尺寸。

带尺寸的图片:
在图片链接后，空一格，=255x255。即“ =你期望的尺寸x尺寸”，其中左右可以不相等，“x”为小写字母x。

居中的图片: Alt
在图片链接后，直接加上#pic_center，即“#pic_center”。

居中并且带尺寸的图片:
在图片链接后，加上#pic_center =30x30，即“#pic_center =30x30”，注意空格。

当然，我们为了让用户更加便捷，我们增加了图片拖拽功能。
确实非常方便了，用的最多的还是复制黏贴。

如何插入一段漂亮的代码片

去博客设置页面，选择一款你喜欢的代码片高亮样式，下面展示同样高亮的 代码片.

// An highlighted block
var foo = 'bar';

优快云编辑内容时，上方的导航给了“代码块”的选项，一键插入。如果你要自己敲，可以用“```代码```”，键入
` ` ` Enter code Enter ` ` `
上方的语法为：

```javascript
// An highlighted block
var foo = 'bar';
// 注：此行还有三个```

生成一个适合你的列表

项目
- 项目
  - 项目

即-space项目。这是无序列表，可以分级，二级列表为Tab-space项目。上述语法为：

- 项目
	- 项目
    	- 项目

项目1
项目2
项目3

即“1. ”。键入number.space项目

计划任务
完成任务

- [ ] 计划任务-space[space]space
- [x] 完成任务-space[x]space
这条语法我也才知道。适合做Todolist，不过这种应该有很多专门的软件。

创建一个表格

一个简单的表格是这么创建的：

项目	Value
电脑	$1600
手机	$12
导管	$1

这里我用代码块显示语法比较方便：

| 第一列 | 第二列 |
|--|--|
| 内容 | 内容 |

其实左右两边的“|”可以省略，我一般会加，因为好看XD

第一列 | 第二列
--|--
内容 | 内容

设定内容居中、居左、居右

使用:---------:居中
使用:----------居左
使用----------:居右

第一列	第二列	第三列
第一列文本居中	第二列文本居右	第三列文本居左

一般默认居中。上面的表格语法如下：

| 第一列 | 第二列 | 第三列 |
|:-----------:| -------------:|:-------------|
| 第一列文本居中 | 第二列文本居右  | 第三列文本居左 |

SmartyPants

SmartyPants将ASCII标点字符转换为“智能”印刷标点HTML实体。例如：

TYPE	ASCII	HTML
Single backticks	`'Isn't this fun?'`	‘Isn’t this fun?’
Quotes	`"Isn't this fun?"`	“Isn’t this fun?”
Dashes	`-- is en-dash, --- is em-dash`	– is en-dash, — is em-dash

创建一个自定义列表

Markdown

Text-to- HTML conversion tool

Authors

John

Luke

上述语法如下：

Markdown
:  Text-to-HTML conversion tool

Authors
:  John
:  Luke

如何创建一个注脚

一个具有注脚的文本。²

上述语法如下：

一个具有注脚的文本。[^2]

[^2]: 注脚的解释

注意：两条都要敲。

注释也是必不可少的

Markdown将文本转换为 HTML。

*[HTML]: 超文本标记语言
意思是另起一行后敲上面的语法，会给“[]”里的内容一个注释，鼠标光标移动到对应内容位置可以显示。

KaTeX数学公式

上面我说过的！ $\LaTeX$
只不过优快云内置的Markdown只支持 $\KaTeX$ 。也就是说可能有些LaTeX环境在这里是用不了的。
我也有几篇关于 $\LaTeX$ 的博客，详见 LaTeX专栏。
$\LaTeX$ 语法这里不再赘述，有兴趣的可以搜一搜，网上有语法整合。

您可以使用渲染LaTeX数学表达式 KaTeX:

Gamma公式展示：
$\Gamma(n) = (n-1)!\quad\forall n\in\mathbb N$ 是通过欧拉积分
$\Gamma(z) = \int_0^\infty t^{z-1}e^{-t}dt\,.$

渲染前：

Gamma公式展示：
$\Gamma(n) = (n-1)!\quad\forall n\in\mathbb N$ 是通过欧拉积分
$$
\Gamma(z) = \int_0^\infty t^{z-1}e^{-t}dt\,.
$$

“$ $”表示行内公式，“$$ $$”表示行间公式。“\,”是一种空格语法，我也有归纳，详见此处

你可以找到更多关于的信息 LaTeX 数学表达式here.
你可以找到更多关于的信息 **LaTeX** 数学表达式[here][1].
这里有个链接的语法，所以标出来。“here”的具体链接在文末给出。
我其实习惯直接在文中给出，即“[名字](链接)”。不过此处这种方法可以使（编辑时的）正文更加简洁，比较推荐用于正式的文章。

新的甘特图功能，丰富你的文章

上述语法为：

```mermaid
gantt
        dateFormat  YYYY-MM-DD
        title Adding GANTT diagram functionality to mermaid
        section 现有任务
        已完成               :done,    des1, 2014-01-06,2014-01-08
        进行中               :active,  des2, 2014-01-09, 3d
        计划一               :         des3, after des2, 5d
        计划二               :         des4, after des3, 5d
// ```

关于 甘特图 语法，参考这儿.

- 关于 **甘特图** 语法，参考 [这儿][2]
优快云给了链接，挺好的，直接点就行了。看不懂英文或者打不开的网上动动手搜。

UML 图表

可以使用UML图表进行渲染。 Mermaid.

例如下面产生的一个序列图：

上述语法为：

```mermaid
sequenceDiagram
张三 ->> 李四: 你好！李四, 最近怎么样?
李四-->>王五: 你最近怎么样，王五？
李四--x 张三: 我很好，谢谢!
李四-x 王五: 我很好，谢谢!
Note right of 王五: 李四想了很长时间, 文字太长了<br/>不适合放在一行.

李四-->>张三: 打量着王五...
张三->>王五: 很好... 王五, 你怎么样?
// 注：此处同样有```结尾

流程图：

上述语法为：

```mermaid
graph LR
A[长方形] -- 链接 --> B((圆))
A --> C(圆角长方形)
B --> D{菱形}
C --> D
// ```

关于 Mermaid 语法，参考这儿,

- 关于 **Mermaid** 语法，参考 [这儿][3],

FLowchart流程图

支持flowchart流程图：

上述语法为：

```mermaid
flowchat
st=>start: 开始
e=>end: 结束
op=>operation: 我的操作
cond=>condition: 确认？

st->op->cond
cond(yes)->e
cond(no)->op
// ```

关于 Flowchart流程图 语法，参考这儿.

- 关于 **Flowchart流程图** 语法，参考 [这儿][4].

导出与导入

导出

如果你想尝试使用此编辑器, 你可以在此篇文章任意编辑。当你完成了一篇文章的写作, 在上方工具栏找到 文章导出 ，生成一个.md文件或者.html文件进行本地保存。

导入

如果你想加载一篇你写过的.md文件，在上方工具栏可以选择导入功能进行对应扩展名的文件导入，
继续你的创作。

文末给出链接，一一对应：

[1]: http://meta.math.stackexchange.com/questions/5020/mathjax-basic-tutorial-and-quick-reference
[2]: https://mermaidjs.github.io/
[3]: https://mermaidjs.github.io/
[4]: http://adrai.github.io/flowchart.js/
// 编辑完成后预览，这些链接是不会显示的。

文章的最后，在分割线下会有“1.”“2.”等标记的注脚，这个是自动显示的。点击小箭头可跳转正文注脚处。
另外，附赠一个小技巧，如果你想手动分割，与上方内容空一行，敲三个减号“-”就可以了。