Markdown is created by Daring Fireball, the original guideline is here. Its syntax, however, varies between different parsers or editors.
Please note that HTML fragments in markdown source will be recognized but not parsed or rendered. Also, there may be small reformatting on the original markdown source code after saving.
Paragraph and line breaks(段落与换行)
A paragraph is simply one or more consecutive lines of text. In markdown source code, paragraphs are separated by more than one blank lines. In Typora, you only need to press Return
to create a new paragraph.
Press Shift
+ Return
to create a single line break. However, most markdown parser will ignore single line break, to make other markdown parsers recognize your line break, you can leave two whitespace at the end of the line, or insert <br/>
.
Headers(标题)
Headers use 1-6 hash characters at the start of the line, corresponding to header levels 1-6. For example:
|
|
In typora, input ‘#’s followed by title content, and press Return
key will create a header.
Blockquotes(引言)
Markdown uses email-style > characters for block quoting. They are presented as:
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.
这是一段中文测试。
In typora, just input ‘>’ followed by quote contents a block quote is generated. Typora will insert proper ‘>’ or line break for you. Block quote inside anther block quote is allowed by adding additional levels of ‘>’.
Lists(有序无序列表)
Input * list item 1
will create an un-ordered list, the *
symbol can be replace with +
or -
.
Input 1. list item 1
will create an ordered list, their markdown source code is like:
- Red
- Green
- Blue
- Red
- Green
- Blue
Task List(任务列表)
Task lists are lists with items marked as either [ ]
or [x]
(incomplete or complete). For example:
- a task list item
- list syntax required
- normal formatting, @mentions, #1234 refs
- incomplete
- completed
You can change the complete/incomplete state by click the checkbox before the item.
Syntax Highlighting(代码高亮)
|
|
|
|
Math Blocks(数学块)
You can render LaTeX mathematical expressions using MathJax.
Input $$
, then press ‘Return’ key will trigger an input field which accept Tex/LaTex source. Following is an example:
$$
\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}
$$
In markdown source file, math block is LaTeX expression wrapped by ‘$$’ mark:
|
|
Tables(表格)
Input | First Header | Second Header |
and press return
key will create a table with two column.
After table is created, focus on that table will pop up a toolbar for table, where you can resize, align, or delete table. You can also use context menu to copy and add/delete column/row.
Following descriptions can be skipped, as markdown source code for tables are generated by typora automatically.
In markdown source code, they look like:
|
|
Name | Markdown | HTML tag |
---|---|---|
Emphasis | *Emphasis* | <em></em> |
Strong | **Strong** | <strong></strong> |
code | `code` | <code></code> |
~~Strikethrough~~ | <del></del | |
Underline | <u>underline</u> | <u></u> |
Footnotes(注释)
|
|
will produce:
You can create footnotes like this1.
Mouse on the ‘footnote’ superscript to see content of the footnote.
Horizontal Rules(水平线)
Input ***
or ---
on a blank line and press return
will draw a horizontal line.
Links(超链接)
Markdown supports two style of links: inline and reference.
In both styles, the link text is delimited by [square brackets].
To create an inline link, use a set of regular parentheses immediately after the link text’s closing square bracket. Inside the parentheses, put the URL where you want the link to point, along with an optional title for the link, surrounded in quotes. For example:
|
|
will produce:
This is an example inline link. (<p>This is <a href="http://example.com/" title="Title">
)
This link has no title attribute. (<p><a href="http://example.net/">This link</a> has no
)
Internal Links(页内链接)
You can set the href to headers, which will create a bookmark that allow you to jump to that section after clicking. For example:
Command(on Windows: Ctrl) + Click This link will jump to header Block Elements
. To see how to write that, please move cursor or click that link with ⌘
key pressed to expand the element into markdown source.
Reference Links(参考链接)
Reference-style links use a second set of square brackets, inside which you place a label of your choosing to identify the link:
|
|
In typora, they will be rendered like:
This is an example reference-style link.
The implicit link name shortcut allows you to omit the name of the link, in which case the link text itself is used as the name. Just use an empty set of square brackets — e.g., to link the word “Google” to the google.com web site, you could simply write:
|
|
In typora click link will expand it for editing, command+click will open the hyperlink in web browser.
URLs
Typora allows you to insert urls as links, wrapped by <
brackets>
.
<i@typora.io>
becomes i@typora.io.
Typora will aslo auto link standard URLs. e.g: www.google.com.
Images(图片)
Image looks similar with links, but it requires an additional !
char before the start of link. Image syntax looks like this:
|
|
You are able to use drag & drop to insert image from image file or we browser. And modify the markdown source code by clicking on the image. Relative path will be used if image is in same directory or sub-directory with current editing document when drag & drop.
For more tips on images, please read http://support.typora.io//Images/
Emphasis(突出强调)
Markdown treats asterisks (*
) and underscores (_
) as indicators of emphasis. Text wrapped with one *
or _
will be wrapped with an HTML <em>
tag. E.g:
|
|
output:
single asterisks
single underscores
GFM will ignores underscores in words, which is commonly used in code and names, like this:
wow_great_stuff
do_this_and_do_that_and_another_thing.
To produce a literal asterisk or underscore at a position where it would otherwise be used as an emphasis delimiter, you can backslash escape it:
|
|
Typora recommends to use *
symbol.
Strong(加粗)
double *’s or _’s will be wrapped with an HTML <strong>
tag, e.g:
|
|
output:
double asterisks
double underscores
Typora recommends to use **
symbol.
Code(代码块)
To indicate a span of code, wrap it with backtick quotes (`). Unlike a pre-formatted code block, a code span indicates code within a normal paragraph. For example:
|
|
will produce:
Use the printf()
function.
highlight shortcode(高亮代码块)
example:
|
|
result:
|
|
Strikethrough(删除线)
GFM adds syntax to create strikethrough text, which is missing from standard Markdown.
~~Mistaken text.~~
becomes Mistaken text.
Underline(下划线)
Underline is powered by raw HTML.
<u>Underline</u>
becomes Underline.
Emoji :happy:(表情)
Input emoji with syntax :smile:
.
User can trigger auto-complete suggestions for emoji by pressing ESC
key, or trigger it automatically after enable it on preference panel. Also, input UTF8 emoji char directly from Edit
-> Emoji & Symbols
from menu bar is also supported.
Inline Math
To use this feature, first, please enable it in Preference
Panel -> Markdown
Tab. Then use $
to wrap TeX command, for example: $\lim_{x \to \infty} \exp(-x) = 0$
will be rendered as LaTeX command.
To trigger inline preview for inline math: input “$”, then press ESC
key, then input TeX command, a preview tooltip will be visible like below:
![](https://typora.io/img/inline-math.gif)
Here is the text of the footnote. ↩︎