Markdown 是Daring Fireball 先生创建的,原始使用规范在这里 ,但是在不同的语法分析器和编辑器中,具体用法会有差别。Typora 使用的是Github Flavored Markdown 。
概述
block Elements
Paragraph and line breaks段落和换行
一个段落是一行或者多行文本组成,在markdown源代码中,段落是由一个以上的空白行分开。在 Pypora 中,你只需要按 Return
就可以新建一个段落。
按 Shift
+ Return
就可以新建一个空白换行。但是,大多数markdown解释器会忽视这种空白换行,你可以行尾按两次空白键实现换行,或者键入
。
Headers标题
标题使用 #
个数来表示相关标题的级数。
# This is an H1
## This is an H2
### This is an H6
Blockquotes 代码块
Markdown uses email-style > characters for block quoting. They are presented as:
> This is a block quote with two paragraphs. This is first paragraph.
>
> this is second pragragh.Vestibulum enim wisi, viverra nec, fringlilla in, laoreet vitae, risus.
Lists列表
输入 *list item 1
可以新建一个无序的列表,*
可以用 -
或 +
。
输入 1. list item 1
可以新建一个无序的列表。
## un-ordered list
* Red
* Green
* Blue
## ordered list
1. Red
2. Green
3. Blue
Task List 任务列表
任务列表是可以用[ ] or [X] 标记的列表。
- [ ] a task list item
- [ ] list syntax required
- [ ] normal **formatting**, @mentions, #1234 refs
- [ ] incomplete
- [x] completed
(Fenced)Code Blocks 代码块
这是 Typora 只支持栅栏代码块,输入 ``` 然后按 Return(快捷键更方便)。
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
```
Math Blocks 公式块
使用MathJax (一个跨浏览器的JavaScript库) 渲染 LaTeX 数学表达式
在markdown 源文件中,公式块的LaTeX 表达式包在 ‘$$’ mark:
$$
\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}
$$
Tables 表格
输入 |��� First Header� | Second Header |�
按 return
键,会新建一个两栏的表格。
Footnotes 注脚
You can create footnotes like this[^footnote]
[^footnote]: here is the *text* of the **footnote**
效果:
You can create footnotes like this[1] .
鼠标移动到注脚的位子是,会显示:![](/Users/c137rick/Documents/Typora/屏幕快照 2018-10-31 上午6.06.41.png)
Horizontal Rules 水平线规则
输入 ***
或者 ---
在空白行按 Return
可以画一条水平线。
Yaml Front Matter
Typora 支持 YAML 了,在文章的顶部输入 ---
然后 return
Table of Contents(TOC)
输入 [toc]
return
会显示文章目录,会自动跟新,本文目录。
Diagrams 示意图
Typora 支持 sequence, flowchart 和 mermaid。
更多细节参考 document。
Span Elements
Span Elements 可以在输入立即解析渲染元素。在这渲染后的元素中间移动光标会将这些元素扩展为markdown源,以下将解释这些Span Elements的语法。
Links 链接
Markdown 支持两种链接:内链接和引用。
在两种方式中,链接的文本用中括号[]括住。:smile:
要创建内联链接,请在链接文本的结束方括号后立即使用一组小括号。在括号内,将URL指向要指向的链接,以及链接的可选标题,用引号括起来。例如:
This is [an example](http://example.com/ "Title") inline link.
[This link](http://example.net/) has no title attribute.
This is an example inline link.
This link has no title attribute.
斜体、加粗、下划线和中线
斜体
用 *
或者 _
包住文本
*斜体*
_斜体_
加粗
用双 *
或者 _
包住文本
中画线
GFM添加了中画线的语法,在标准的Markdown 语法里面没有。
~~中画线~~、
种花心啊
下划线
下划线是HTML语法
下划线
下划线
Emoji :smile:
语法 :smile:
:joy: :prince:
html
你甚至可以在 Typora 用HTML, 使用 this text is red
就可以给文本添加红色。
Embed Contents 嵌入内容
例子:
Video
可以用 HTML 标签放入视频:
Other HTML Support
更多信息 这里 。
-
here is the text of the footnote . ↩