Markdown For Typora文档(中文版)
今天下午闲来无事,又仔细看了一遍Typora里面的Markdown参考文档。顺便把它翻译成中文的md文档。在下翻译水平有限,请大家指出。有需要这个文档的md源文件的可以联系我的邮箱。
复制代码
概述
Markdown是由Daring Fireball所创建,它最初的指引说明在这里。但是,它的语法和变量在不同的解析器或者编辑器中是不同的。Typora正在使用 [GitHub Flavored Markdown][GFM].
[TOC]
块元素
段落与换行
一个段落只是一个或多个连续的文本行。在markdown源代码中,段落被两个或多个空行所分隔。在Typora中,你只需要一个空行(按一次回车键
)去创建一个新的段落。
按 Shift
+ Return
创建一个换行符。 大多数其他markdown解析器会忽略单个换行符,所以为了让其他markdown解析器识别你的换行符,你可以在行尾留两个空格,或者插入<br/>
。
标题
标题在行首使用1-6个井号符(#),对应标题等级1-6。例如:
# This is an H1
## This is an H2
###### This is an H6
复制代码
在 Typora 中,输入‘#’后跟标题内容,然后按回车键将创建一个标题。它们呈现为:
块引用
Markdown使用电子邮件风格的 > 字符进行块引用。
> 这是含有两个段落的块引用。这是第一段。
>
> 这是第二段。因为这就是为什么它不是卡通片,它在里面,有很多生活,笑声。
>> 嵌套使用
> 这是另一个带有一段的引用。 有三个空行来分隔两个块引用。
复制代码
在 Typora 中,输入 ‘>’ 后跟引用内容将生成一个引用块。 Typora 会为你插入一个合适的 ‘>’ 或换行符。 通过添加额外级别的“>”来嵌套块引用(另一个块引用中的块引用)。
列表
输入* 列表项1
将创建一个无序列表,*
号可以被 +
或 -
替代
输入1. 列表项1
将创建一个有序列表,他们的markdown源码如下:
## 无序列表
* 红
* 绿
* 蓝
## ordered list
1. 红
2. 绿
3. 蓝
复制代码
任务列表
任务列表是带有标记为 [ ] 或 [x](分别代表或完成)的项目的列表。 例如:
- [ ] 一个任务列表项
- [ ] 列表所需语法
- [ ] normal **formatting**, @mentions, #1234 refs
- [ ] 未完成
- [x] 已完成
复制代码
您可以通过点击项目前的复选框来更改已完成/未完成状态。
(围栏式)代码块
Typora仅支持在GitHub Flavored Markdown上的围栏代码块。原始的markdown代码块不支持。
使用围栏很简单:输入` 然后按
回车键,在“`后面添加可选的语言标识符。我们将通过语法高亮来运行它。
这是一个例子
```js
function test() {
console.log("notice the blank line before this function?");
}
```
语法高亮:
```ruby
require 'redcarpet'
markdown = Redcarpet.new("Hello World!")
puts markdown.to_html
```
复制代码
数学块
你可以使用MathJax来渲染LaTex数学表达式。
输入$$
然后按回车键去添加一个数学表达式。这将会触发一个接受Tex/LaTex源的输入字段。例如: