Markdown语法 #
块状元素 #
段落和换行 #
一个段落只是一个或多个连续的文本行。在 markdown 源代码中,段落由两行或多行空行分隔。在 Typora 中,你只需要一个空行(按一次 Return
)就可以创建一个新段落。
按 Shift
+ Return
来创建一个单行断句。大多数其他的 markdown 解析器会忽略单行断句,所以为了让其他 markdown 解析器识别你的断行,你可以在行尾留两个空格,或者插入 <br/>
。
标题 #
标题在行首使用 1-6 个 ( #
) 字符,对应于标题级别 1-6. 比如说。
# This is an H1
## This is an H2
###### This is an H6
在 Typora 中,输入'#'后的标题内容,按 Return
键就可以创建一个标题。或者输入⌘ 1 到⌘ 6 作为快捷方式。
方块引号 #
Markdown 使用 > 字符来进行块状引用。它们的表现形式是:
> This is a blockquote with two paragraphs. This is first paragraph.
>
> This is second paragraph. Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
> This is another blockquote with one paragraph. There is three empty line to separate two blockquotes.
在 Typora 中,输入'>',然后再输入你的引号内容,将产生一个引号块。Typora 将为你插入一个适当的'>'或换行符。通过添加额外的">"层,可以实现嵌套式的区块引号(一个区块引号在另一个区块引号内)。
列表 #
输入 * list item 1
将创建一个无序的列表。( *
符号可以用 +
或 -
替换。)
输入 1. list item 1
,将创建一个有序的列表。
比如说:
## un-ordered list
* Red
* Green
* Blue
## ordered list
1. Red
2. Green
3. Blue
任务列表 #
任务清单是带有标记为 [ ] 或 [x] (未完成或已完成)的项目的清单。比如说:
- [ ] a task list item
- [ ] list syntax required
- [ ] normal **formatting**, @mentions, #1234 refs
- [ ] incomplete
- [x] completed
你可以通过点击项目前的复选框来改变完整/不完整状态。
代码块 #
输入 and press `return`. Add an optional language identifier after
时,Typora 会对其语法高亮:
Here's an example:
```
function test() {
console.log("notice the blank line before this function?");
}
```
syntax highlighting:
```ruby
require 'redcarpet'
markdown = Redcarpet.new("Hello World!")
puts markdown.to_html
```
数学公式 #
你可以使用 MathJax 渲染 LaTeX 数学表达式。
要添加一个数学表达式,请输入 $$
,然后按'返回'键。这将触发一个接受 Tex/LaTex 源的输入字段。比如说。
V1×V2= ∣∣∣∣∣ i ∂ X ∂ u ∂ vj ∂ Y ∂ u ∂ vk00 ∣∣∣∣∣ V1×V2=|ijk ∂ X ∂ u ∂ Y ∂ u0 ∂ X ∂ v ∂ 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}
$$
你可以找到更多的细节 here (opens new window) 。
表格 #
标准 Markdown 已经以多种方式进行了扩展,增加了对表格的支持。包括 GFM。Typora 通过一个图形界面来支持,或者直接写源代码。
输入 | First Header | Second Header |
并按 return
键。这将创建一个有两列的表格。
在创建了一个表格后,将焦点放在该表格上,将打开该表格的工具栏,你可以调整大小、对齐或删除该表格。你还可以使用上下文菜单来复制和添加/删除个别列/行。
下面介绍了表格的完整语法,但没有必要详细了解完整的语法,因为表格的 markdown 源代码是由 Typora 自动生成的。
在 markdown 源代码中,它们看起来像。
| First Header | Second Header |
| ------------- | ------------- |
| Content Cell | Content Cell |
| Content Cell | Content Cell |
你也可以在表格中包括内联的 Markdown,如链接、粗体、斜体或删除线。
通过在标题行内包含冒号 ( :
),你可以将该列中的文本设置为左对齐、右对齐或居中对齐。
| Left-Aligned | Center Aligned | Right Aligned |
| :------------ |:---------------:| -----:|
| col 3 is | some wordy text | $1600 |
| col 2 is | centered | $12 |
| zebra stripes | are neat | $1 |
最左边的冒号表示左对齐的列;最右边的冒号表示右对齐的列;两边的冒号表示中间对齐的列。
脚注 #
MultiMarkdown 扩展了标准 Markdown,提供了两种添加脚注的方法。
你可以创建 reference footnotes ,比如这个 1 (opens new window) 和这个 2 (opens new window) 。
将产生。
You can create footnotes like this[^fn1] and this[^fn2].
[^fn1]: Here is the *text* of the first **footnote**.
[^fn2]: Here is the *text* of the second **footnote**.
将鼠标悬停在'fn1'或'fn2'上标上,可以看到脚注的内容。你可以使用任何你喜欢的独特标识作为脚注标记(例如 "fn1")。
将鼠标悬停在脚注的上标上,可以看到脚注的内容。
分割线 #
在空行上输入 ***
或 ---
,然后按 return
,就会画出一条横线。
YAML 前面的内容 #
Typora 现在支持 YAML Front Matter (opens new window)。在文章的顶部输入 ---
,然后按 Return
,引入一个元数据块。另外,你也可以从 Typora 的顶部菜单中插入一个元数据块。
目录(TOC) #
输入 [toc]
并按下 Return
键,创建一个 "目录 "部分。TOC 从文件中提取所有的标题,其内容会随着你对文件的添加而自动更新。
链接 #
Markdown 支持两种风格的链接:内联和引用。
在这两种风格中,链接文本都由 [方括号] 划定。
内联链接 #
要创建一个内联链接,请在链接文本的结尾方括号后立即使用一组普通的括号。在括号内,把你想让链接指向的 URL,以及一个可选的链接标题,用引号包围。比如说。
This is [an example](http://example.com/ "Title") inline link.
[This link](http://example.net/) has no title attribute.
这是 an example (opens new window) 内联链接。( <p>This is <a href="http://example.com/" title="Title">
)
This link (opens new window) 没有标题属性。() <p><a href="http://example.net/">This link</a> has no
内部链接 #
要创建一个内部链接,创建一个 "书签",让你在点击后跳转到该部分,使用标题元素的名称作为 href。比如说。
按住 Cmd(在 Windows 上:Ctrl)并点击 this link (opens new window),跳到标题 Block Elements
。
Hold down Cmd (on Windows: Ctrl) and click on [this link](#block-elements) to jump to header `Block Elements`.
参考链接 #
参考样式的链接使用第二组方括号,在里面放置一个你选择的标签,以识别链接。
This is [an example][id] reference-style link.
Then, anywhere in the document, you define your link label on a line by itself like this:
[id]: http://example.com/ "Optional Title Here"
在 Typora 中,它们将被渲染成这样。
这是 an example (opens new window) 参考文献式的链接。
隐含链接名称的快捷方式允许你省略链接的名称,在这种情况下,链接文本本身被用作名称。只需使用一组空的方括号--例如,要将 "Google "这个词链接到 google.com 网站,你可以简单地写。
[Google][]
And then define the link:
[Google]: http://google.com/
在 Typora 中,点击链接将展开它进行编辑,而命令 + 点击将在你的网络浏览器中打开该超链接。
URLs #
Typora 允许你插入 URL 作为链接,由 <
括号 >
。例如,<[email protected]>
变成 [email protected]。
Typora 也会自动链接标准的 URLs(例如:www.google.com),而不需要这些括号。
图片 #
图片的语法与链接相似,但它们需要在链接开始前增加一个 !
字符。插入图片的语法是这样的。
![Alt text](/path/to/img.jpg)
![Alt text](/path/to/img.jpg "Optional title")
你能够使用拖放的方式,从图像文件或你的网络浏览器中插入一个图像。你可以通过点击图片来修改 markdown 源代码。如果用拖放方式添加的图像与你目前正在编辑的文件在同一目录或子目录下,则将使用相对路径。
如果你使用 markdown 来建立网站,你可以在 YAML Front Matter 中用属性 typora-root-url
,为本地电脑上的图片预览指定一个 URL 前缀。例如,在 YAML Front Matter 中输入 typora-root-url:/User/Abner/Website/typora.io/
,然后 ![alt](/blog/img/test.png)
,在 Typora 中会被当作 ![alt](file:///User/Abner/Website/typora.io/blog/img/test.png)
。
强调 #
Markdown 将星号 ( *
) 和下划线 ( _
) 作为强调的标志。用一个 *
或 _
包裹的文本将被一个 HTML <em>
标签包裹。比如说。
*single asterisks*
_single underscores_
生产。
_ 单星号 _
单一下划线 _
GFM 会忽略单词中的下划线,这在代码和名称中是常用的,比如这样。
哗众取宠
做这个,做那个,还有另一件事。
如果要在某个位置产生一个字面的星号或下划线,否则它将被用作强调分隔符,你可以用反斜杠字符来转义它。
\*this text is surrounded by literal asterisks\*
Typora 建议使用 *
符号。
加粗 #
双重的 *
或 _
将导致其包含的内容被一个 HTML <strong>
标签所包裹,例如
**double asterisks**
__double underscores__
生产。
** 双星号 **
** 双下划线 **
Typora 建议使用 **
符号。
内联代码 #
要表示一个内联的代码跨度,请用反斜线引号(`)来包裹它。与预先格式化的代码块不同,代码跨度表示正常段落中的代码。比如说。
Use the `printf()` function.
将产生。
使用 printf()
功能。
删除线 #
GFM 增加了创建删除线文本的语法,这是标准 Markdown 中所缺少的。
~~Mistaken text.~~
变成 ~~ 错误的文本。
表情符号:happy: #
输入表情符号的语法 :smile:
。为方便起见,在输入 :
和表情符号名称的开头后,会弹出一个自动完成帮助器。
也支持直接输入 UTF-8 的表情符号,在菜单栏中进入 编辑
-> Emoji & Symbols
。
Inline Math #
要使用这个功能,请先在偏好设置的 Markdown
标签中启用它。然后,使用 $
来包装一个 LaTeX 命令。例如:$\lim_{x \to \infty} \exp(-x) = 0$
。
触发内联数学的内联预览:输入"$",然后按 ESC
键,再输入一条 TeX 命令。
你可以找到更多的细节 here (opens new window) 。
下标 #
要使用这个功能,请先在偏好设置的 Markdown
标签中启用它。然后,使用 ~
来包装下标内容。例如。H~2~O
, X~long\ text~
/
上标 #
要使用这个功能,请先在偏好设置的 Markdown
标签中启用它。然后,使用 ^
来包装上标内容。例如:X^2^
。
亮点 #
要使用这个功能,请先在偏好设置的 Markdown
标签中启用它。然后,使用 ==
来包装高亮内容。例如:==highlight==
。
HTML #
你可以用 HTML 来为纯 Markdown 不支持的内容样式。例如,使用 <span style="color:red">this text is red</span>
来添加红色的文本。
下划线 #
GFM 的 Markdown 中没有指定下划线,但可以通过使用下划线的 HTML 标签产生。
<u>Underline</u>
成为下划线。
嵌入内容 #
一些网站提供基于 iframe 的嵌入代码,你也可以将其粘贴到 Typora 中。比如说。
<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 支持 #
你可以找到更多的细节 here (opens new window) 。
下面是 text ,第一个 footnote 。↩ (opens new window)
下面是 text ,第二个 footnote 。↩ (opens new window)