diff --git a/README.md b/README.md
index 862d865..1d022fc 100644
--- a/README.md
+++ b/README.md
@@ -119,7 +119,7 @@
 
 本节通过“Hello World”示例代码，指导读者创建第一个ESP32工程，并完成编译、烧录及运行调试流程。通过本节内容，初学者可以初步体验ESP-IDF的开发流程，快速进入ESP32开发的世界。  
 
-- 在线文字教程：[ESP32初体验-idf.py的基本使用](docs/01.认识ESP32/1.3-初试ESP32-idf.py的基本使用/idf.py的基本使用.md)
+- 在线文字教程：[ESP32初体验-idf.py的基本使用.md](docs/01.认识ESP32/1.3-初试ESP32-idf.py的基本使用/idf.py的基本使用.md)
 - 在线视频教程：[ESP32初体验-idf.py的基本使用]
 
 ---
@@ -132,7 +132,7 @@
 
 本节详细介绍ESP-IDF项目的基本目录结构与构建流程，包括CMake工具的基础知识，帮助读者掌握ESP32工程的整体组织方式，为日后开发复杂项目奠定基础。  
 
-- 在线文字教程：[ESP32工程结构及构建](./docs/02.IDF基础与工具使用/2.1-ESP32工程结构及构建/ESP32工程结构及构建.md)
+- 在线文字教程：[ESP32工程结构及构建.md](./docs/02.IDF基础与工具使用/2.1-ESP32工程结构及构建/ESP32工程结构及构建.md)
 - 在线视频教程：[ESP32工程结构及构建]  
 - 教程配套代码：[基础工程模板](#)  
 
@@ -140,7 +140,7 @@
 
 本节将重点讲解如何使用`menuconfig`工具配置项目，包含常见的配置选项及其实际用途。通过本节学习，读者可以根据项目需求快速定制和优化ESP32项目配置。  
 
-- 在线文字教程：[ESP-IDF项目配置](./docs/02.IDF基础与工具使用/2.2-ESP-IDF项目配置/ESP-IDF项目配置.md)  
+- 在线文字教程：[ESP-IDF项目配置.md](./docs/02.IDF基础与工具使用/2.2-ESP-IDF项目配置/ESP-IDF项目配置.md)  
 - 在线视频教程：[ESP-IDF项目配置详解]  
 - 教程配套代码：[项目配置示例代码](#)  
 
@@ -148,7 +148,7 @@
 
 本节讲解如何创建和管理ESP-IDF的自定义组件，包括组件的目录结构、声明与调用方法，以及组件的复用和共享技巧，帮助读者构建模块化项目。  
 
-- 在线文字教程：[ESP-IDF自定义组件](./docs/02.IDF基础与工具使用/2.3-ESP-IDF自定义组件/ESP-IDF自定义组件.md)
+- 在线文字教程：[ESP-IDF自定义组件.md](./docs/02.IDF基础与工具使用/2.3-ESP-IDF自定义组件/ESP-IDF自定义组件.md)
 - 在线视频教程：[ESP-IDF自定义组件开发详解]  
 - 教程配套代码：[组件示例代码](#)  
 
@@ -156,7 +156,7 @@
 
 本节重点介绍ESP-IDF组件管理器的功能与使用方法，涵盖如何通过组件管理器导入外部库、配置组件依赖，以及解决组件冲突的问题，帮助读者高效管理复杂项目的依赖关系。  
 
-- 在线文字教程：[ESP-IDF组件管理器](./docs/02.IDF基础与工具使用/2.4-ESP-IDF组件管理器/ESP-IDF组件管理器.md)  
+- 在线文字教程：[ESP-IDF组件管理器.md](./docs/02.IDF基础与工具使用/2.4-ESP-IDF组件管理器/ESP-IDF组件管理器.md)  
 - 在线视频教程：[ESP-IDF组件管理器详解]  
 - 教程配套代码：[组件管理器示例代码](#)  
 
diff --git a/docs/00.常见问题及解决方案/常见问题及解决方案.md b/docs/00.常见问题及解决方案/常见问题及解决方案.md
index 48fb07c..ef92eda 100644
--- a/docs/00.常见问题及解决方案/常见问题及解决方案.md
+++ b/docs/00.常见问题及解决方案/常见问题及解决方案.md
@@ -1,6 +1,7 @@
 
 ## 1. 头文件无法跳转，没有代码提示
-#### **问题**：
+
+**问题**：
 
 >我们使用VS Code打开ESP32项目，有时我们的代码头文件无法跳转，写代码没有代码提示。
 
@@ -10,7 +11,7 @@
 
 ![](attachments/20240129232435.png)
 
-#### 解决方案：
+**解决方案**：
 
 先编译代码：
 
@@ -44,19 +45,20 @@
 
 ## 2.开发板在Windows下可以显示端口，但在Linux下找不到
 
-#### **问题**：
+ **问题**：
 
 >开发板在Windows下可以显示端口，但在Linux下找不到
 
 这种情况一般是由于开发板的USB转串口芯片在Linux下没有驱动程序导致的，特别是USB转串口芯片为CH340的开发板，容易找不到驱动。（所以推荐使用USB转串口芯片型号为CP210x的开发板）。
-#### 解决方案：
+
+**解决方案**：
 
 安装对应型号的串口驱动程序，上网搜索安装教程一般都能找到。
 
 
 ## 3.Linux下烧录代码报错（没有串口权限）
 
-#### **问题**：
+**问题**：
 
 >Linux下烧录代码报错（没有串口权限）
 
@@ -65,7 +67,8 @@
 ![](attachments/20250107091923.png)
 
 这是由于我们的linux用户没有读写串口的权限
-#### 解决方案：
+
+**解决方案**：
 
 可以使用下面的命令添加串口读写权限（也可直接切换root用户）：