Markdown 语法 with Typora

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 数学表达式
\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 源文件中,公式块的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

更多信息 这里 。


  1. here is the text of the footnote . ↩

你可能感兴趣的:(Markdown 语法 with Typora)