记笔记从学Typora开始-----(3)markdown基本实践一
上节我们讲解了Typora软件的界面总览和组成,也给童鞋们推荐了常用的偏好设置。这一节就接一节末尾所提,根据官方给的Markdown Reference进行翻译成中文,方便同学阅读和学习Typora的基本使用,让大家快速上手使用!
文章目录
1、打开Markdown Reference
2、学习元素目录截图
这是官方提供的整个目录,但是为了减轻大家的学习压力,我们只翻译红框的前半部分,后半部分就放下节吧!
3、正式开始翻译
Markdown For Typora
- 总览
- 块元素
- 段落和换行
- 标题
- 块引用
- 列表
- 任务列表
- 代码块
- 数学公式块
- 表格
- 脚注
- 水平分割线
- YAML Front Matter
- 目录
总览
Markdown是由Daring Fireball创建的。但是,它的语法因不同的解析器或编辑器而异。Typora使用GitHub风格的Markdown!
块元素
(1)段落和换行
一个段落就是一个或多个连续的文本行。在Markdown源代码中,段落由两个或多个空行分隔。在Typora中,你只需要一个空行(按Return
一次)来创建一个新段落。
按Shift + Return
创建单行换行。大多数其他标记解析器将忽略单行换行符,因此为了使其他标记解析器识别您的换行符,您可以在行尾留下两个空格或插入<br/>
。
(2)标题
标题在行首使用1-6个散列(“#”)字符,对应标题级别1-6。例如:
# This is an H1
## This is an H2
### This is an H3
#### This is an H4
##### This is an H5
###### This is an H6
在Typora中,输入 #
,然后是标题内容,然后按 Return
键将创建标题
(3)块引用
Markdown使用电子邮件样式的>
字符进行块引用。它们呈现为:
> 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.
在Typora中,输入 >
和你的引用内容将生成一个引用块。Typora会为你插入一个合适的 >
或换行符。通过添加额外的 >
级别来嵌套块引号(一个块引号在另一个块引号内)。
(4)列表
输入* list item 1
将创建一个无序列表 *
符号可以替换为 +
或 -
。
输入1. 列表项目1
将创建一个有序列表——它们的Markdown源代码如下:
## un-ordered list
* Red
* Green
* Blue
## ordered list
1. Red
2. Green
3. Blue
(5)任务列表
任务列表是带有标记为[]
或[x]
(未完成或已完成)的项的列表。例如:
- [ ] a task list item
- [ ] list syntax required
- [ ] normal **formatting**, @mentions, #1234 refs
- [ ] incomplete
- [x] completed
您可以通过单击项目前的复选框来更改完成/未完成状态。
(6)代码块
Typora只支持fenced的GitHub风格的Markdown格式。不支持markdown中的原始代码块。
使用栅栏很简单:输入```,然后按Enter
键。或是```紧跟着添加一个可选的语言标识符(如:c++),我们将通过语法高亮显示来运行它:
Here's an example:
```js
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
```
(7)数学公式块
您可以使用MathJax呈现LaTeX数学表达式。
要添加数学表达式,请输入$$
并按Enter
键。这将触发一个接受Tex/LaTex源的输入字段。例如:
V
1
×
V
2
=
∣
i
j
k
∂
X
∂
u
∂
Y
∂
u
0
∂
X
∂
v
∂
Y
∂
v
0
∣
\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}
V1×V2=
i∂u∂X∂v∂Xj∂u∂Y∂v∂Yk00
在markdown源文件中,数学块是由一对$$
标记包装的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}
$$
你可以在这里找到更多的细节。
(8)表格
输入| First Header | Second Header |
并按Enter
键。这将创建一个包含两列的表格。
创建表之后,将焦点放在该表上将打开该表的工具栏,您可以在其中调整表的大小、对齐或删除表。您还可以使用上下文菜单来复制和添加/删除单个列/行。
下面描述了表的完整语法,但是不需要详细了解完整语法,因为表格的Markdown源代码是由Typora自动生成的。
在Markdown源代码中,它们看起来像:
| First Header | Second Header |
| ------------- | ------------- |
| Content Cell | Content Cell |
| Content Cell | Content Cell |
实际效果如下:
First Header | Second Header |
---|---|
Content Cell | Content Cell |
Content Cell | Content Cell |
还可以在表中包括内联标记,如链接、粗体、斜体或划线。
最后,通过在标题行中包含冒号(‘:’),您可以将该列中的文本定义为左对齐、右对齐或居中对齐。
| Left-Aligned | Center Aligned | Right Aligned |
| :------------ |:---------------:| -----:|
| col 3 is | some wordy text | $1600 |
| col 2 is | centered | $12 |
| zebra stripes | are neat | $1 |
最左边的冒号表示左对齐的列;最右边的冒号表示右对齐的列;两边的冒号表示中间对齐的列。
实际效果如下:
Left-Aligned | Center Aligned | Right Aligned |
---|---|---|
col 3 is | some wordy text | $1600 |
col 2 is | centered | $12 |
zebra stripes | are neat | $1 |
(9)注脚
You can create footnotes like this[^footnote].
[^footnote]: Here is the *text* of the **footnote**.
将产生:
You can create footnotes like this1.
将鼠标悬停在“脚注”上标上可查看脚注的内容。
(10)水平分割线
在空白行上输入***
或 —-—
并按下return
键将绘制一条水平线。
如下:
(11)YAML Front Matter
Typora现在支持YAML Front Matter,在文章的顶部输入—-—
,然后按Return
以引入元数据块。或者,您可以从Typora的顶部菜单插入元数据块。
示例如下:
(12)目录
输入[toc]
并按Enter
键。这将创建一个目录
部分。TOC从文档中提取所有标题,并在添加到文档时自动更新其内容。
如下:
文章目录
4、常见概念答疑解惑
(1)Typora和Markdown是什么关系?
Markdown是一种轻量级标记语言,用于格式化纯文本。它的设计目的是让文本易于阅读、编写和编辑,同时可以转换为多种格式(如HTML、PDF等)。Markdown由John Gruber和Aaron Swartz于2004年创建,主要用于编写文档、说明文件、博客文章等。
Typora是一款Markdown编辑器,它提供了所见即所得(WYSIWYG,What You See Is What You Get)的编辑体验。
总结如下: Typora是基于Markdown语言的一款编辑器,它通过提供所见即所得的编辑体验、扩展的功能支持、便捷的文件导出和自定义样式,使得编写和管理Markdown文档变得更加高效和友好
(2)YAML Front Matter是什么?有啥用?
YAML Front Matter是一种元数据标记方式,通常用于在文件的开头添加一些结构化的数据。这些数据可以用来描述文件的属性或配置文件的行为。YAML Front Matter最常用于静态网站生成器(如Jekyll、Hugo)和Markdown文件中,以便指定一些额外的参数或元数据。
常用用途如下:
- 元数据存储
YAML Front Matter用于存储文件的元数据,如标题、日期、作者、标签等。这些元数据可以被解析器读取,并用于生成内容页面或配置页面行为 - 内容管理
在静态网站生成器中,YAML Front Matter可以用于管理内容页面的属性。比如,在Jekyll中,可以使用这些元数据来生成页面的头部信息,配置页面模板等 - 动态配置
YAML Front Matter允许用户定义一些动态配置参数,这些参数可以在页面生成时使用。例如,可以指定页面的布局、是否包含某些组件、SEO设置等 - 分类和标签
通过YAML Front Matter,可以为内容页面添加分类和标签,便于内容的组织和检索。静态网站生成器可以利用这些信息生成分类页面和标签页面 - 模板渲染
元数据可以与模板引擎结合使用,动态生成页面内容。比如,可以在模板中使用元数据来渲染页面的标题、日期、作者信息等
注:下一节,咱们继续官方文档下半部分继续哦!大家拭目以待!我是航火火,火一般的男人!
Here is the text of the footnote. ↩︎