Typora基础使用教程-Markdown的使用
Markdown 是由Daring Fireball 创造的,Typora正在使用
块元素
段落和换行符
段落只是一行或多行连续的文本。在markdown源代码中,段落由两行或多行空行分隔。在Typora中,您只需要一个空行(按一次Enter
)就可以创建一个新段落。
按Shift
+Enter
创建一个换行符。大多数其他标记解析器都会忽略单行分隔符,因此为了让其他标记解析器识别您的行分隔符,您可以在行的末尾留下两个空格,或者插入<br/>
。
标题
标头在行首使用1-6个哈希(#
)字符,对应于标头级别1-6。例如:
# 这是H1
## 这是H2
###### 这是H6
在Typora中,输入“#”,后跟标题内容,然后按Enter
键将创建标题。
引用块
Markdown使用email-style>字符进行块引用。它们表示为:
> 这是一个由两段组成的大引号。这是第一段。
>
> 这是第二个
> 这是另一个带有一段的大引号。两个blockquote之间有三个空行。
在Typora中,输入>
后跟内容将生成块块引用。Typora将为您插入一个正确的>
或换行符。嵌套的块引号(另一个块引号中的块引号),方法是添加额外的'>'级别。
列表
输入* list item 1
将创建一个无序列表*
符号可以替换为+
或-
。
输入1。list item 1
将创建一个有序列表-其markdown源代码如下:
## 未排序列表
*红色
*绿色
*蓝色
## 有序列表
1.红色
2.绿色
3.蓝色
任务列表
任务列表是带有标记为[]或[x](不完整或完整)的项的列表。例如:
-[ ]任务列表项
-[ ]需要列出语法
-[ ]正常**格式**,@提及,#1234参考
-[ ]不完整
-[x]已完成
您可以通过单击项目前面的复选框来更改完成/未完成状态。
(围栏)代码块
Typora只支持GitHub风格的markdown。不支持标记中的原始代码块。
使用fences很简单:输入```后并按Enter
。在之后添加一个可选的语言标识符,我们将通过语法高亮显示来运行它:
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源的输入字段。例如:
在markdown源文件中,数学块是由一对“$$”标记包装的LaTeX表达式:
$$
\mathbf
$$
你可以在这里找到更多的细节(https://support.typora.io/Math/).
表格
输入|第一个标题|第二个标题|
,然后按Enter
键。这将创建一个包含两列的表。
创建表后,将焦点放在该表上将打开该表的工具栏,您可以在其中调整、对齐或删除该表。也可以使用关联菜单复制和添加/删除单个列/行。
表的完整语法如下所述,但不必详细了解完整语法,因为表的markdown源代码是由Typora自动生成的。
在markdown源代码中,它们看起来像:
|第一个头|第二个头|
| ------------- | ------------- |
|内容单元格|内容单元格|
|内容单元格|内容单元格|
还可以在表中包含内联标记,如链接、粗体、斜体或删除线。
最后,通过在标题行中包含冒号(:
),可以将该列中的文本定义为左对齐、右对齐或居中对齐:
| 左对齐 | 居中对齐 | 右对齐 |
| :------------ |:---------------:| -----:|
| col 3 is | some wordy text | $1600 |
| col 2 is | centered | $12 |
| zebra stripes | are neat | $1 |
最左侧的冒号表示左对齐的列;最右侧的冒号表示右对齐的列;两侧的冒号表示居中对齐的列。
脚注
您可以创建这样的脚注[^footnote]。
[^footnote]:这是**脚注**的*文本*。
将产生: 您可以创建这样的脚注footnote。 footnote:这是脚注的文本。 将光标悬停在“footnote”上标上可查看脚注的内容。
横线规则
在空行上输入***
或---
,然后按回车
键,将画一条水平线。
YAML Front Matter
Typora现在支持. 在文章顶部输入---
,然后按Enter
引入元数据块。或者,您可以从Typora的顶部菜单插入元数据块。
目录(TOC)
输入[toc]
,然后按Enter
键。这将创建一个目录
部分。TOC从文档中提取所有标题,并且当您添加到文档中时,其内容会自动更新。
跨度元素
Span元素将在键入后立即进行分析和呈现。将光标移到这些span元素的中间将把这些元素展开为markdown source。下面是每个span元素的语法说明。
链接
Markdown支持两种链接样式:inline和reference。 在这两种样式中,链接文本都由[方括号]分隔。 要创建内联链接,请在链接文本的右方括号之后立即使用一组常规括号。在圆括号内,将链接指向的URL以及链接的可选标题放在引号中。例如:
这是 [一个例子](http://example.com/ “标题”)内联链接。
[此链接](http://example.net/)没有标题属性。
将产生:
这是[一个例子](http://example.com/“标题”)内联链接。(<p>这是<a href='http://example.com/“title=”title“>
)
没有标题属性。(<p><a href='http://example.net/“>此链接</a>
)
内部链接
您可以将href设置为headers,这将创建一个书签,允许您在单击后跳转到该节。例如:
命令(在Windows上:Ctrl)+单击将跳转到标题block elements
。若要查看如何写入,请移动光标或单击该链接并按⌘
键,将元素展开到markdown 源代码中。
参考链接
参照样式链接使用第二组方括号,在其中放置所选标签以标识链接:
这是[an example][id]引用样式链接。
然后,在文档中的任何位置,您可以在一行上自行定义链接标签,如下所示:
[id]:http://example.com/ “此处为可选标题”
在Typora中,它们将被呈现为: 这是引用样式链接。
隐式链接名称快捷方式允许您省略链接的名称,在这种情况下,链接文本本身用作名称。只需使用一组空的方括号——例如,将单词“Google”链接到谷歌网站网站上,您只需写下:
[谷歌][]
然后定义链接:
[谷歌]:http://google.com/
在Typora中,单击链接将展开它进行编辑,command+单击将在web浏览器中打开超链接。
网址
Typora允许您将url作为链接插入,并用<
brackets>
包装。
<i@typora.io>
变成i@typora.io.
Typora也会自动链接标准网址。例如:www.google.com。
图像
图像的语法与链接类似,但它们需要一个附加的!
链接开始前的字符。插入图像的语法如下所示:
![替换文本](/path/to/图片.jpg)
![替换文本](/path/to/图片.jpg “可选标题”)
您可以使用拖放从图像文件或web浏览器插入图像。您可以通过单击图像来修改markdown源代码。如果使用拖放添加的图像与当前正在编辑的文档位于同一目录或子目录中,则将使用相对路径。
如果您正在使用markdown来构建网站,则可以使用YAML Front Matters中的typora-root-url
属性为本地计算机上的图像预览指定URL前缀。例如,输入typora-root-url:/User/Abner/Website/typora.io/
在YAML Front Matters,然后![alt](/blog/img/test.png)
将被视为![alt](file:///User/Abner/Website/typora.io/blog/img/test.png)
。
你可以在这里找到更多的细节(https://support.typora.io/Images/).
强调
Markdown将星号(*
)和下划线(作为强调的指标。用一个`*`或
包装的文本将用一个HTML <em>
标记包装。例如:
*单个星号*
_单下划线_
输出: 单个星号 单下划线 GFM将忽略单词中的下划线,通常用于代码和名称中,如下所示:
哇哦,很棒的东西
做这个做那个做另一件事。
要在原本用作强调分隔符的位置生成文字星号或下划线,可以对其进行反斜杠转义:
\*此文本由文字星号包围\*
Typora 建议使用 *
符号.
加粗
双*
或`将使其包含的内容用HTML
<strong>`标记包装,例如:
**双星号**
__双下划线__
输出:
双星号
双下划线
Typora建议使用**
符号。
代码
要指示代码的内联范围,请用反引号(`)将其括起来。与预先格式化的代码块不同,代码跨度表示正常段落中的代码。例如:
使用`printf()`函数。
将产生:
使用printf()
函数。
删除线
GFM添加了语法来创建删除线文本,这是标准标记中缺少的。
~~错误的文本。~~
变成了错误的文本
下划线
下划线由原始HTML提供支持。
<u> 下划线</u>
变成下划线。
表情符号:😄
使用语法:smile:
输入表情符号。
用户可以通过按ESC
键触发emoji的自动完成建议,或者在首选项
面板上启用后自动触发。此外,在菜单栏(macOS)中的“Edit”->“emoji&Symbols”也支持直接输入UTF-8表情符号。
内联数学
要使用此功能,请先在首选项
面板->Markdown
选项卡中启用它。然后,使用$
包装TeX命令。例如:$\lim_{x \to \infty} \exp(-x) = 0$
将作为LaTeX命令呈现。
要触发内联数学的内联预览:输入“$”,然后按ESC
键,然后输入TeX命令。
你可以在这里找到更多的细节(https://support.typora.io/Math/).
下标
要使用此功能,请先在首选项
面板->Markdown
选项卡中启用它。然后,使用~
包装下标内容。例如:H~2~O
,X~long\text~
上标
要使用此功能,请先在首选项
面板->Markdown
选项卡中启用它。然后,使用^
包装上标内容。例如:X^2^
。
突出显示
要使用此功能,请先在首选项
面板->Markdown
选项卡中启用它。然后,使用==
包装突出显示的内容。例如:==突出显示==
。
HTML格式
您可以使用HTML来设置纯标记不支持的内容的样式。例如,使用<span style="color:red">this text is red</span>
添加红色文本。
嵌入内容
有些网站提供基于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支持
你可以点击 查看更多内容。