Markdown For SEUITE

为SEUITE翻译的markdown手册

Markdown For SEUITE

概览

Markdown 由Daring Fireball设计而成；这里是原指南。不过，各个编辑器和解析器的Markdown语法都有所不同。SEUITE选用 GitHub Flavored Markdown为标准。

块元素

段落与换行符

Markdown 中，一个段落是指数行连续的文本，而空行被用来划分段落。然而在 SEUITE 里，你无需空行，直接换行即可划分出一个新的段落。

同时按下Shift + Return可以创建单个换行符，以实现换行而不分段。而在大多数其它的 markdown 解析器中，这种单个换行符会被忽略，你可以在行末空两格，或插入 来实现换行而不分段。

标题

我们在行首使用1到6个#号来标记标题，依次对应1至6级标题。例如：

# 这是1级标题

## 这是2级标题

###### 这是6级标题

在 SEUITE 中，输入#后接标题内容，并按下Return，即可新建一个标题。

块引用

Markdown 使用电子邮件样式的>符来标记块引用。它们表示为：

> 这是一个包含两段的块引用。 这是第一段。
>
> 这是第二段。Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.

> 这是另一个带有一个段落的块引用。 有三个空行分隔两个块引用

在 SEUITE 中，输入>后接你的引用内容将会生成一个引用块，SEUITE 会为你插入一个正确的>或换行符。若要在引用内嵌入另一个引用，只需输入两级>。

列表

输入* 列表项1将创建无序列表，其中*可以用+或-替换。

输入1. 列表项1将创建有序列表。它们的 markdown 代码如下：

## 无序列表
*   红
*   绿
*   蓝

## 有序列表
1.  红
2. 	绿
3.	蓝

任务列表

任务列表是有[ ]（未完成）或[x]（已完成）标记的列表。例如：

- [ ] 任务列表项
- [ ] 使用列表的语法
- [ ] 支持正常的**格式**，@提及，引用#1234 
- [ ] 未完成项
- [x] 已完成项

只需单击项目前的框即可更改已完成/未完成状态

（围栏式）代码块

SEUITE 仅支持 GitHub Flavored Markdown 中的代码围栏，而不支持 markdown 中原生的代码块。

使用代码围栏非常简单：输入```符并回车。可以在```后写上语言标识符以开启语法高亮。

这是一个例子。

数学公式块

你可以用 MathJax 来渲染 $L^AT_EX$。

输入$$并回车来添加数学表达式，这将启用一个支持 $TeX/L^AT_EX$ 的输入区。例如：

$\mathbf{V}_1 \times \mathbf{V}_2 = \begin{vmatrix} \mathbf{i} & \mathbf{j} & \mathbf{k} \\ \frac{\partial X}{\partial u} & \frac{\partial Y}{\partial u} & 0 \\ \frac{\partial X}{\partial v} & \frac{\partial Y}{\partial v} & 0 \\ \end{vmatrix}$

在 markdown 代码中，数学公式块由一对$$标记：

$$
\mathbf{V}_1 \times \mathbf{V}_2 =  \begin{vmatrix}
\mathbf{i} & \mathbf{j} & \mathbf{k} \\
\frac{\partial X}{\partial u} &  \frac{\partial Y}{\partial u} & 0 \\
\frac{\partial X}{\partial v} &  \frac{\partial Y}{\partial v} & 0 \\
\end{vmatrix}
$$

更多详情请见此处。

表格

输入 | 标题一 | 标题二 | 并按 Return 键将会新建一个两列的表格。

在表格被创建后，将光标移至表格上会打开表格工具栏，你可以在其中调整表格，对齐或删除表格。你也可以用内容菜单来复制和添加。删除单个列/行。

表格的完整语法如下所示，不过由于 SEUITE 将会自动生成表格的 markdown 代码，你无需理解代码的全部细节。

在markdown源代码中，它们像这样：

|   标题一   |  标题二   |
| --------- | --------- |
| 单元格内容 | 单元格内容 |
| 单元格内容 | 单元格内容 |

你还可以在表格中使用行内的 markdown ，诸如链接、粗体、斜体或删除线。

还有，通过在标题行中使用:，可以设定该列的对齐方式：左对齐，右对齐，或居中：

|  左对齐  |    居中    | 右对齐 |
| :------ |:----------:| -----:|
| 第三栏是 | 啰嗦的文字~ | $1600 |
| 第二栏是 | 中心格      |   $12 |
| 斑马条纹 | 很整洁呢    |    $1 |

最左侧的冒号表示左对齐的列; 最右侧的冒号表示右对齐的列; 两边都有一个冒号表示居中的列。

Footnotes

你可以像这样创建脚注[^脚注]。

[^脚注]：这是**脚注**的*文本*。

将生成：

你可以像这样创建脚注[^脚注]。 [ ^脚注 ]：这是脚注的文本。

将鼠标悬停在“脚注”上标上可查看脚注的内容。

分割线

在空行上输入***或---并按Return将会绘制一条分割线：

YAML 头信息

SEUITE 现在支持 YAML头信息。在文档顶部输入---并按Return来引入元数据块，或者在 SEUITE 的顶部菜单栏也可以插入元数据块。

目录 (TOC)

输入[toc]并按Return键将会生成一个“目录”块，它将提取全文的所有标题，并且能够自动更新。

Span 元素

Span 元素将在输入后即刻解析并呈现。当光标移至这些 span 元素上时将会把它们展开为 markdown 源码。以下是各个 span 元素的语法解释。

链接

Markdown支持两种链接样式：内联和参考。

在这两种样式中，链接文本都由[方括号]分隔。

要创建内联链接，请在链接文本的结束方括号后紧跟一组普通括号，并将你想要链接指向的URL，以及链接的可选标题放在括号内。例如：

这是[示例](http://example.com/ "标题")内联链接。

[该链接](http://example.net/) 没有标题属性。

会生成：

这是示例内联链接。(示例 <a href="http://example.com/" title="标题">)

该链接没有标题属性。(<a href="http://example.net/">该链接</a>没有)

页内跳转链接

你可以将跳转目标指向标题, 这将创建一个书签，允许你在单击后跳转到该部分。例如：

按住⌘(在Windows上：Ctrl)的同时单击此链接将会跳转至标题块元素。若想知道如何书写，请将光标移至链接或单击链接，同时按下⌘来将链接展开为 markdown 源码。

参考链接

参考样式链接使用第二组方括号，在其中放置你选择的标签以标识链接：

这是[一个示例][id]参考样式链接

随后，在文档中的任一位置，你可以单独在一行上定义链接标签，如下所示：

[id]: http://example.com/  "可选标题"

在SEUITE中，它们将被渲染为：

这是一个示例参考样式链接

隐式链接名称快捷方式允许你省略链接的名称，在这种情况下，链接文本本身将用作名称。只需使用一组空的方括号——例如，将“Google”一词链接到 google.com 网站，可以简写为：

[Google][]

随后定义链接：

[Google]: http://google.com/

在SEUITE中，单击该链接将展开它以进行编辑，同时，⌘+单击将在Web浏览器中打开超链接。

网址

SEUITE允许你将URL作为链接插入，由包围。尖括号>

<i@SEUITE.io> 显示为i@SEUITE.io。

SEUITE还会自动链接标准网址。例如： www.google.com 。

图片

图像具有与链接类似的语法，但它们在链接前需要额外的！。插入图像的语法如下所示：

![替代文字](/path/to/img.jpg)

![替代文字](/path/to/img.jpg "可选标题")

你可以使用拖放操作来从图像文件或Web浏览器插入图像。你可以通过单击图片来修改 markdown 源代码。如果使用拖放操作添加的图像与你当前编辑的文档位于同一目录或子目录中，则将使用相对路径。

如果你使用 markdown 搭建网站，你可能需要在头信息中用参数SEUITE-root-url为你的本地预览指定一个 URL 前缀。例如，在头信息中输入SEUITE-root-url:/User/Abner/Website/SEUITE.io/，然后在 SEUITE 中![alt](/blog/img/test.png)将会被当作` alt 。

更多详情请见此处.

强调

Markdown 把星号(*)以及下划线(_)作为强调的标记。被一对* _包围的文本在编译时会由HTML 标记包围例如：

*单对星号*

_单对下划线_

生成：

单对星号

单对下划线

GFM会忽略代码和名称单词中常见的下划线，像这样：

wow_great_stuff

do_this_and_do_that_and_another_thing.

使用反斜杠来避免星号或下划线被编译为强调标记：

\*本文本被一对可见星号包围\*

SEUITE 推荐使用*作为强调标记。

加粗

一对双*或_会使得它们包围的内容在编译时由HTML标签标记，例如：

**双星号**

__双下划线__

output:

双星号

双下划线

SEUITE推荐使用**作为加粗标记。

代码

用一对 ` 包围行内代码来显示它。与预格式化的代码块不同，行内代码不会分段。例如：

Use the `printf()` function.

将生成：

Use the printf() function.

删除线

GFM 加入了用来显示删除线的语法，而原生 markdown 并没有。

~~Mistaken text.~~显示为~~Mistaken text.~~

下划线

下划线由原始 HTML 实现。

Underline显示为Underline.

###表情符号

用:emoji:来输入表情符号.

你可以用ESC键启用表情符号的自动补全建议，也可以在首选项中开启它来自动触发。同时，也支持直接输入 UTF-8 的表情符号，请至菜单栏中的Edit -> Emoji & Symbols浏览。

行内数学公式

要使用此功能，请先在Preference -> Markdown中启用它。随后，用$来包围 TeX 代码。例如： $\lim_{x \to \infty} \exp(-x) = 0$ 会渲染为$\lim_{x \to \infty} \exp(-x) = 0$

要开启行内数学公式的行内预览，请输入$后按ESC，再输入 TeX代码。

更多详情请见此处.

下标

要使用此功能，请先在Preference -> Markdown中启用它。随后，使用~来包围想要下标的文本。例如：H~2~O，X~long\ text~/。

上标

要使用此功能，请先在Preference -> Markdown中启用它。随后，使用^来包围想要下标的文本。例如：X^2^。

高亮

要使用此功能，请先在Preference -> Markdown中启用它。随后，使用==来包围想要下标的文本。例如：==highlight==。

HTML

你可以使用 HTML 来实现纯 markdown 不支持的格式。例如，使用this text is red来添加红字。

嵌入内容

有些网站提供基于iframe的嵌入代码，你也可以将其粘贴到SEUITE中。例如：

<iframe height='265' scrolling='no' title='Fancy Animated SVG Menu' src='http://codepen.io/jeangontijo/embed/OxVywj/?height=265&theme-id=0&default-tab=css,result&embed-version=2' frameborder='no' allowtransparency='true' allowfullscreen='true' style='width: 100%;'></iframe>

视频

你可以使用<video> HTML 标签来嵌入视频。例如：

<video src="xxx.mp4" />

其它HTML支持

更多详情请见此处.

上篇常用笔微评测

下篇Under Maintenance