记笔记从学Typora开始-----（3）markdown基本实践一

记笔记从学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源的输入字段。例如：
$${\mathbf{V}}_1\times {\mathbf{V}}_2=\left|\begin{array}{ccc}\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{array}\right|$$
​ 在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 this¹.

​ 将鼠标悬停在“脚注”上标上可查看脚注的内容。

（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，可以为内容页面添加分类和标签，便于内容的组织和检索。静态网站生成器可以利用这些信息生成分类页面和标签页面
• 模板渲染
  元数据可以与模板引擎结合使用，动态生成页面内容。比如，可以在模板中使用元数据来渲染页面的标题、日期、作者信息等

注：下一节，咱们继续官方文档下半部分继续哦！大家拭目以待！我是航火火，火一般的男人！

---

1. Here is the text of the footnote. ↩︎