Jimmy那些事儿

Markdown使用手册_typora

发表 | 更新 | 分类 ， ， | 阅读次数

概述

Markdown是由Daring Fireball创建的，原来的指导方针就在这里。然而，其语法因不同的解析器或编辑者而异。Typora正在使用GitHub Flavored Markdown。

请注意，markdown源中的HTML片段将被识别，但不会被解析或呈现。另外，保存后的原始降价源代码可能会重新格式化。

块元素

段落和换行符

一段只是一个或多个连续的文本行。在markdown源代码中，段落由多个空白行分隔。在Typora中，您只需要按Return创建一个新的段落。

按Shift+ Return创建一个换行符。但是，大多数markdown解析器将忽略单行中断，使其他分解器识别您的换行符，您可以在行尾留下两个空格或插入``。

标题

标题在行开始使用1-6个散列字符，对应于标题级别1-6。例如：

1
2
3
4
5
# This is an H1
## This is an H2
###### This is an H6

在typora中，输入’＃’后跟标题内容，Return按键将创建一个标题。

块引用

Markdown使用电子邮件风格>字符进行块引用。它们被表示为：

1
2
3
4
5
6
7
> This is a blockquote with two paragraphs. This is first paragraph.
>
> This is second pragraph.Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
> This is another blockquote with one paragraph. There is three empty line to seperate two blockquote.

在typora中，只需输入’>’后跟引用内容就会生成一个块引用。Typora将为您插入适当的“>”或换行符。通过添加额外的“>”级别可以允许在另一个块引用内嵌一个引号。

列表

输入* list item 1将创建一个无序列表，该*符号可以替换为+或-。

输入1. list item 1将创建一个有序列表，它们的markdown源代码如下：

1
2
3
4
5
6
7
8
9
## un-ordered list
*   Red
*   Green
*   Blue
## ordered list
1.  Red
2. 	Green
3.	Blue

任务列表

任务列表是标有[]或[x]（不完整或完整）的项目的列表。例如：

1
2
3
4
5
- [ ] a task list item
- [ ] list syntax required
- [ ] normal **formatting**, @mentions, #1234 refs
- [ ] incomplete
- [x] completed

您可以通过单击项目之前的复选框来更改完整/不完整的状态。

（围栏）代码块

Typora只支持Github Flavored Markdown中的栅栏。不支持标记中的原始代码块。

使用栅栏很容易：输入“”并按return`。在

1
2

Here’s an example:

​

1
2
3
4
function test() {
  console.log("notice the blank line before this function?");
}
​

syntax highlighting:
​

1
2
3
4
require 'redcarpet'
markdown = Redcarpet.new("Hello World!")
puts markdown.to_html
​

1
2
3
4
5
6
7
8
9
10
### 数学块
您可以 使用**MathJax**渲染  *LaTeX*数学表达式  。****
输入`$$`，然后按“返回”键将触发一个接受*Tex / LaTex*源的输入字段。以下是一个例子：
V1× V2= |||||一世∂X∂你∂X∂vj∂Y∂你∂Y∂vk00|||||V1×V2=|一世jk∂X∂你∂Y∂你0∂X∂v∂Y∂v0|
在markdown源文件中，数学块是由'$$'标记包裹的*LaTeX*表达式：

$$
\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}
$$

1
2
3
4
5
6
7
8
9
10
### 表
输入`| First Header | Second Header |`和`return`按键将创建一个带有两列的表。
创建表之后，将重点放在该表上将弹出一个表的工具栏，您可以在其中调整大小，对齐或删除表。您还可以使用上下文菜单来复制和添加/删除列/行。
以下描述可以跳过，因为表的markdown源代码是由typora自动生成的。
在markdown源代码中，它们看起来像：
First Header Second Header
Content Cell Content Cell
Content Cell Content Cell 
1
2
3
4
您还可以包括内联Markdown，如链接，粗体，斜体或删除线。
最后，通过包含冒号：在标题行中，您可以定义要左对齐，右对齐或中心对齐的文本：
Left-Aligned Center Aligned Right Aligned
col 3 is some wordy text $1600
col 2 is centered $12
zebra stripes are neat $1 
1
2
3
4
最左侧的冒号表示左对齐的列; 最右侧的结肠指示右对齐的柱; 两侧的结肠表示中心对齐的柱。
### 脚注

You can create footnotes like this[^footnote].

[^footnote]: Here is the text of the footnote.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
将产生：
你可以创建这样的脚注[1](http://support.typora.io/Markdown-Reference/#fn:footnote)。
鼠标在“脚注”上标上查看脚注的内容。
### 水平规则
输入`***`或`---`空白行，按下`return`将画一条水平线。
------
### YAML前线事宜
Typora支持[YAML Front Matters](http://jekyllrb.com/docs/frontmatter/)。输入`---`文章顶部，然后按下`Enter`将会介绍一个。或从菜单中插入一个元数据块。
### 目录（TOC）
输入，`[toc]`然后`Return`按键将创建一个“目录”部分，从一个人的写作中提取所有标题，其内容将自动更新。
## 跨度元素
您的打字后，Span元素将被解析并呈现。在这些span元素的中间移动光标将这些元素扩展为markdown源。以下将介绍这些span元素的语法。
### 链接
Markdown支持两种风格的链接：内联和引用。
在两种样式中，链接文本由[方括号]分隔。
要创建内联链接，请在链接文本的关闭方括号后立即使用一组常规括号。在括号内，将链接所在的网址与链接的可选标题一起放在引号中。例如：

This is an example inline link.

This link has no title attribute.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
将产生：
这是[一个](http://example.com/%22Title%22)内联链接[示例](http://example.com/%22Title%22)。（`This is [`](http://example.com/)）
[此链接](http://example.net/)没有标题属性。（`[This link](http://example.net/) has no`）
#### 内部链接
**您可以将href设置为标题**，这将创建一个书签，允许您在单击后跳转到该部分。例如：
命令（在Windows上：Ctrl）+单击[此链接](http://support.typora.io/Markdown-Reference/#block-elements)将跳转到标题`Block Elements`。要查看如何写，请移动光标或点击该`⌘`按钮，将该元素展开为markdown源。
#### 参考链接
参考样式链接使用第二组方括号，您可以在其中放置您选择的标签来标识链接：

This is an example reference-style link.

Then, anywhere in the document, you define your link label like this, on a line by itself:

1
2
3
4
5
6
在typora中，它们将被渲染为：
这是[一个示例](http://example.com/)参考样式的链接。
隐式链接名称快捷方式允许您省略链接的名称，在这种情况下，将链接文本本身用作名称。只需使用一组空白的方括号 - 例如，将Google“Google”链接到google.com网站，您可以简单地写：

Google
And then define the link:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
在typora中，点击链接将扩展它进行编辑，命令+单击将打开Web浏览器中的超链接。
### 网址
Typora允许您将URL作为链接插入，用`<`括号括起来`>`。
``成为[i@typora.io](mailto:i@typora.io)。
Typora将自动链接标准URL。例如：www.google.com。
### 图片
图像看起来与链接类似，但`!`在链接开始之前需要一个额外的char。图像语法如下所示：

Alt text

Alt text

1
2
3
4
5
6
7
8
9
10
您可以使用拖放来从图像文件或浏览器插入图像。并通过点击图像修改markdown源代码。如果图像与当前编辑文档在同一目录或子目录中拖放时，将使用相对路径。
如果您使用markdown构建网站，则可以在本地计算机中`typora-root-url`为YAML Front Matters中的属性指定用于图像预览的网址前缀。例如，`typora-root-url:/User/Abner/Website/typora.io/`在YAML Front Matters中输入，然后`![alt](/blog/img/test.png)`将被视为`![alt](file:///User/Abner/Website/typora.io/blog/img/test.png)`类似的。
![拖放图像](http://typora.io/img/drag-img.gif)
### 重点
Markdown将星号（`*`）和下划线（`_`）作为重点的指示。用一个包装的文本`*`或`_`将被HTML ``标签包装的文本。例如：

single asterisks

single underscores

1
2
3
4
5
6
7
8
9
10
11
12
13
14
输出：
*单个星号*
*单个下划线*
GFM将忽略通常用于代码和名称的单词中的下划线，如下所示：
> wow_great_stuff
>
> do_this_and_do_that_and_another_thing。
要在一个位置上产生一个文字星号或下划线，否则它将被用作强调分隔符，您可以反斜杠逃避它：

*this text is surrounded by literal asterisks*

1
2
3
4
5
6
Typora建议使用`*`符号。
### 强大
double *或_将包含HTML ``标签，例如：

double asterisks

double underscores

1
2
3
4
5
6
7
8
9
10
11
12
输出：
**双星号**
**双重下划线**
Typora建议使用`**`符号。
### 码
要指示代码跨度，用反引号引号（`）包装。与预格式化的代码块不同，代码段表示正常段落中的代码。例如：

Use the printf() function.

```

将产生：

使用该printf()功能。

删除线

GFM添加语法来创建删除线文本，这在标准的Markdown中是缺少的。

~~Mistaken text.~~ 成为 错误的文字。

强调

下划线由原始HTML提供支持。

Underline成为下划线。

表情：快乐：

使用语法输入表情符号:smile:。

用户可以通过ESC按键触发表情符号的自动填写建议，或者在首选面板上启用后自动触发。此外，还支持从Edit- > Emoji & Symbols从菜单栏直接输入UTF8表情符号字符串。

内联数学

要使用此功能，请先在Preference面板 - > Markdown选项卡中启用该功能。然后$用来包装TeX命令，例如：$\lim_{x \to \infty} \exp(-x) = 0$将被渲染为LaTeX命令。

要触发内联数学的内联预览：输入“$”，然后ESC按键，然后输入TeX命令，预览工具提示将如下所示可见：

内联数学

下标

要使用此功能，请先在Preference面板 - > Markdown选项卡中启用该功能。然后使用~包标内容，例如：H~2~O，X~long\ text~/

上标

要使用此功能，请先在Preference面板 - > Markdown选项卡中启用该功能。然后^用来包含上标内容，例如：X^2^。

突出

要使用此功能，请先在Preference面板 - > Markdown选项卡中启用该功能。然后==用来包装高亮内容，例如：==highlight==。

  1. 这里是文本的的注脚。 ↩