一、Markdown基本语法

标题(#)

Markdown的标题语法用于创建文档的层次结构,使文本内容更具条理和可读性。标题可以将文档划分为不同的部分或章节,帮助读者快速理解文档的结构和重点。通过不同级别的标题,还可以创建嵌套的层次结构,便于组织复杂的信息。

Markdown使用#号来表示标题。#的数量表示标题的级别,#越多,标题级别越低。从一级标题到六级标题,使用#的数量依次递增。

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题

image-20240916122635922

引用(>)

Markdown的引用语法用于引入外部内容、引用他人的话、显示注释或强调某些重要信息。引用块可以让文本内容更具层次感和分辨度,在阅读时能够清晰地区分出主要内容和引用内容。

Markdown使用>符号来创建引用块。每个段落前面添加一个>符号即可将该段落转换为引用块。多个>符号可以创建嵌套引用。

> 引用
>> 二层引用
>>> 三层引用

image-20240916122819315

列表

Markdown的列表语法用于创建有序或无序的项目列表,使文本内容更具条理和层次感。列表能够帮助组织信息,方便读者快速浏览和理解内容。无序列表适合用于列出同级别的重要点或项目,而有序列表则适用于需要表达步骤、顺序或等级的内容。

无序列表(*/-/+)

无序列表使用星号*、加号+或减号-表示列表项,三种符号在Markdown中功能相同。

+ 项目1
- 项目2
  - 项目2.1
    - 项目2.1.1
  - 项目2.2
* 项目3

image-20240916123743196

有序列表(num.)

有序列表使用数字加点来表示列表项。数字的实际值并不重要,渲染器会自动根据顺序进行编号。

1. 项目1
2. 项目2
   1. 项目2.1
        1. 项目2.1.1
   2. 项目2.2
3. 项目3

image-20240916123753316

强调

Markdown的强调语法用于对文本进行加粗或斜体格式化。加粗和斜体可以帮助突出关键字、重要信息或需要特别关注的部分,使读者在阅读时更容易注意到这些内容。强调语法增加了文本的可读性和层次感,提升了文档的整体效果。

斜体文本

斜体使用单个星号*或下划线_包围文本。

*强调文本*
_强调文本_

image-20240916124007022

粗体文本

加粗使用两个星号**或两个下划线__包围文本。

**强调文本**
__强调文本__

image-20240916124137696

斜体粗体文本

同时加粗和斜体使用三个星号***或三个下划线___包围文本。

***强调文本***
___强调文本___

image-20240916124240634

链接

外部链接

创建外部链接的基本语法:[链接文本](链接地址)

[google](www.google.com "点击访问google")
[bilibili](www.bilibili.com)

image-20240916124605894

内部链接

内部链接通常用于跳转到同一文档中的特定部分,通常需要先定义一个锚点或ID,然后在链接中引用该锚点。锚点通常为标题。

[点击跳转到二级标题](#二级标题)

image-20240916124745427

图片

Markdown的图片语法用于在文档中插入图片,使内容更加生动和直观。图片可以用来展示图表、截图、插图、照片等,增强文档的视觉效果和内容的可理解性。与链接语法类似,图片语法也非常简单且灵活,适用于多种场景。

插入图片的基本语法:![替代文本](图片链接)

![百度logo](https://www.baidu.com/img/PCtm_d9c8750bed0b3c7d089fa7d55720d6cf.png)
![本地logo](D:\User\Downloads\mainlogocircular.png)

image-20240916125926611

代码

Markdown的代码语法用于在文档中插入代码片段,使代码部分与普通文本区分开来。代码语法支持行内代码和代码块两种形式,行内代码用于短小的代码片段,而代码块用于多行代码段。代码语法的使用使文档更适合技术类内容,如编程指南、技术博客、API文档等。

行内代码

行内代码使用单反引号(``)包围代码片段。

代码:`test1`

image-20240916130111639

代码块

代码块用于多行代码,使用三个反引号(`````)或缩进四个空格。可以在反引号后指定语言,以启用语法高亮。

```python
a = 1
b = 2
print(a + b)
```

image-20240916130237743

分隔线

Markdown中的分隔线语法非常简单,只需要连续使用三个或更多的星号(*)、减号(-)或下划线(_),并且每种符号的数量至少为三个,可以带或不带空格。

### 标题一
---
### 标题二
***
### 标题三
___

image-20240916130523071

表格

Markdown的表格语法用于在文档中插入表格,使数据和信息以结构化的方式展示。表格可以用来排列和比较数据,增强文档的可读性和信息传达效果。Markdown的表格语法简单直观,适合快速创建和编辑表格。

Markdown的表格使用竖线(|)和连字符(-)来创建。第一行定义表头,第二行定义对齐方式,接下来的行定义表格内容。

表格基本语法:

  1. 表头:使用竖线(|)分隔列,内容写在竖线之间。

  2. 对齐方式:连字符加冒号表示对齐方式。

    • :--- 左对齐

    • :---: 居中对齐

    • ---: 右对齐

  3. 表格内容:每行使用竖线分隔列,内容写在竖线之间。

| 表头1 | 表头2 | 表头3 |
| :--- | :---: | ---: |
| 左对齐 | 居中对齐 | 右对齐 |
| 数据1 | 数据2 | 数据3 |
| 数据4 | 数据5 | 数据6 |

image-20240916130655301

任务列表

Markdown的任务列表(Task List)语法用于创建带有复选框的列表,这些复选框可以表示任务的完成状态。任务列表中的每一项可以是未完成或已完成状态,为用户提供了一种直观的方式来管理和跟踪任务进度。

任务列表基本语法:

任务列表在普通的无序列表基础上,通过在方括号内加空格或“x”来表示任务的状态:

  • [ ] 表示未完成任务

  • [x] 表示已完成任务

每个任务项之前需要有一个连字符(-)和一个空格。

- [x] 学习数学
- [ ] 学习英语

image-20240916130936803

二、写作工具

VSCode

通过VSCode(Visual Studio Code)直接打开一个.md或者.markdown文件,即可进行预览和编辑。

image-20240916131547869

image-20240916131608264

Typora(付费,89元 / 3台设备 / 免费升级)

Typora 官方中文站 (typoraio.cn)

Group-screen.png (2802×1922) (typoraio.cn)

Typora是一款广受欢迎的跨平台Markdown编辑器,支持Windows、macOS和Linux操作系统。通过使用Typora,用户可以轻松地进行笔记记录、文章撰写和代码文档的编写。

与其他编辑器不同,Typora采用所见即所得(实时预览)的编辑模式,这意味着用户可以实时看到最终效果,从而减少在编辑窗口和预览窗口之间切换的麻烦。这种模式不仅简化了操作,使得不需要单独针对代码进行编写和修改,也让新手用户更容易上手。

除了对标准Markdown语法的全面支持,Typora还允许在文档中嵌入HTML和LaTeX代码,以便轻松排版多媒体内容和数学公式。它还可以在写作过程中自动生成文章目录和大纲,大大提高了写作效率。

Typora提供多种主题选择,并支持主题自定义功能。用户可以选择自己喜欢的主题进行安装,或者根据个人需求对现有主题进行修改和改进。

此外,Typora支持通过插件将文档中的图片上传到图床,简化了操作流程,增强了文档的可移植性和分享性。用户还可以将文档导出为PDF、Word、HTML等多种格式,满足不同场景的需求。

总之,Typora凭借其简洁直观的界面和丰富的功能,成为众多写作和编辑任务的理想工具。无论是用于日常笔记、技术文档还是学术论文,Typora都能提供卓越的支持和体验。