Qt6.5实战：用QTextEdit打造一个简易Markdown编辑器（附源码）

Qt6.5实战：用QTextEdit打造一个简易Markdown编辑器（附源码）

你是否曾想过在自己的桌面应用中集成一个轻量级的文档编辑功能，但又不想引入过于庞大复杂的第三方库？或者，你希望为用户提供一个既能编写又能即时预览的Markdown编辑体验，却苦于没有现成的、可深度定制的解决方案？如果你正面临这样的需求，那么Qt6.5中的QTextEdit控件或许就是你一直在寻找的答案。

QTextEdit远不止是一个简单的多行文本框。它内置了对富文本（HTML）和Markdown格式的原生支持，这意味着开发者无需额外引入解析库，就能轻松实现文本的格式化显示与编辑。对于需要为应用添加笔记、日志、配置说明或简易文档编辑功能的开发者来说，利用QTextEdit快速构建一个Markdown编辑器，不仅能显著提升应用的专业度，还能极大地改善用户体验。

本文将带你从零开始，基于Qt6.5，一步步构建一个功能完整的简易Markdown编辑器。我们将聚焦于三个核心功能：实时预览、基础格式工具栏和文件保存/加载。不同于单纯讲解控件属性的理论文章，我们将以实际开发场景切入，手把手教你如何将QTextEdit的强大能力转化为一个可运行的、实用的编辑器。文章末尾会提供完整的项目源码，你可以直接运行、修改并集成到自己的项目中。

1. 项目环境搭建与核心控件解析

在开始编码之前，我们需要确保开发环境就绪。本项目基于Qt 6.5及以上版本，使用CMake作为构建系统。如果你还在使用qmake，迁移到CMake的过程并不复杂，它能提供更现代的依赖管理和跨平台构建体验。

首先，创建一个基本的Qt Widgets Application项目。在你的CMakeLists.txt中，确保包含了必要的模块：

cmake_minimum_required(VERSION 3.16)
project(MarkdownEditor LANGUAGES CXX)

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

find_package(Qt6 REQUIRED COMPONENTS Widgets)
qt_standard_project_setup()

add_executable(MarkdownEditor
    main.cpp
    mainwindow.cpp
    mainwindow.h
    mainwindow.ui
)

target_link_libraries(MarkdownEditor PRIVATE Qt6::Widgets)

接下来，我们来深入了解一下本项目的核心——QTextEdit。很多人误以为它只是一个加强版的QPlainTextEdit，但实际上，它的内核是一个完整的文档对象模型（Document Object Model）。QTextEdit背后关联着一个QTextDocument对象，这个对象以结构化的方式管理着文本内容、段落格式、字符样式，甚至内嵌的图片、列表和表格。

对于Markdown编辑器的实现，我们主要利用QTextEdit的以下两个特性：

• setMarkdown() 与 toMarkdown(): 这是Qt 5.14之后引入的便捷函数。setMarkdown()能将一个Markdown格式的字符串直接渲染为富文本显示在控件中；toMarkdown()则能将控件当前的富文本内容转换回Markdown字符串。这为我们实现