@@ -40,6 +40,7 @@ Choose a portable ZIP on the release page, extract it, and run `FloatNote.exe`.
 Choose an application ZIP, not **Source code**. Extract into a writable folder. Binaries are unsigned and may trigger SmartScreen; SHA-256 checksums are included on the release page.
 
 - Hover near the top to reveal controls; drag the bottom-right grip to resize.
+- Notes start in Markdown preview. Click text to edit; click blank space, a control or another window to save and return to preview. See [Quick start](docs/QUICKSTART.md) for supported syntax.
 - `Ctrl+Alt+E` restores editing; `Ctrl+Alt+H` toggles visibility; `Ctrl+Alt+P` toggles click-through.
 - `Ctrl+wheel` changes font size. Double-click the tray icon to recover the note.
 - To upgrade, exit the old app and replace the executable. **Keep and back up the existing `data` folder.**
 
@@ -40,6 +40,7 @@
 选择应用 ZIP，而非 **Source code**。解压到可写目录；程序未签名，可能触发 SmartScreen。发布页提供 SHA-256 校验文件。
 
 - 顶部显示操作按钮，右下角拖动调整大小。
+- 默认预览 Markdown；点击文字编辑，点击空白、控件或其他窗口后自动保存并回到预览。支持范围见[快速开始](docs/QUICKSTART.md)。
 - `Ctrl+Alt+E` 恢复编辑；`Ctrl+Alt+H` 显示/隐藏；`Ctrl+Alt+P` 切换鼠标穿透。
 - `Ctrl+滚轮` 调整字号；双击托盘图标可找回便签。
 - 升级时退出旧版、替换程序，**保留并备份原目录的 `data` 文件夹**。
 
@@ -1,33 +1,37 @@
-# FloatNote 2.1.0
+# FloatNote 2.2.0
 
-液态玻璃更易读，收放与控件响应更顺畅。
+液态玻璃便签支持 Markdown 自动预览：点击文字编辑，点击别处回到排版后的便签。
 
-- **自动字色**：根据文字区域的实际背景切换深浅字色，平滑过渡，减少反复闪烁。
-- **自适应控件**：黑白控件随周围背景变化；关闭按钮保留红色悬停反馈，尺寸提示跟随正文字色。
-- **玻璃光照**：根据局部背景的颜色和纹理调整曲面明暗与反光。
-- **交互优化**：收放复用着色器与图形资源，加快控件出现；修复窗口较多时独立控件的层级问题。
+- **自动切换**：默认显示预览；点击文字进入原文编辑，点击空白、操作控件或其他窗口后自动保存并返回预览。暂停打字不会退出编辑。
+- **Markdown 排版**：支持标题、粗体、斜体、删除线、有序/无序列表、任务列表、引用、行内代码、围栏代码块和链接文字。
+- **原生编辑**：保留中文输入、光标定位和撤销记录；切换时等待输入法合成结束。空便签仍可点击输入。
+- **玻璃显示**：排版适配窗口宽度和字号，文字保持清晰，预览支持滚动。
+
+内容继续按 Markdown 原文保存在 `data/note.txt`，已有普通文本便签可直接使用。点击链接或任务标记会进入编辑；本版暂不渲染表格、图片和 HTML，也不加载远程内容。Markdown 支持是常用语法子集，并非完整 CommonMark/GFM 实现。
 
 ## 下载与升级
 
 下载 Assets 中的 ZIP，解压运行 `FloatNote.exe`：**x64 适合大多数电脑**，arm64 适合 Windows on ARM，x86 适合 32 位环境。无需额外运行库。
 
 升级前退出旧版，替换 EXE，**保留并备份原目录的 `data` 文件夹**。发布包不含个人数据；校验值见 `SHA256SUMS.txt`。
 
-液态玻璃主要面向支持的 Windows 11 环境。部分截图、录屏和远程共享仍可能看不到实时玻璃，需要时切换毛玻璃；本次未解决该限制。设置和材质面板目前为中文，程序未签名。
+液态玻璃主要面向支持的 Windows 11 环境。部分截图、录屏和远程共享可能看不到实时玻璃，需要时切换毛玻璃。设置和材质面板目前为中文，程序未签名。自动检查不等同于所有输入法、显卡和远程环境的实机验收。
 
 ---
 
 ## English
 
-More readable liquid glass, smoother transitions and more responsive controls.
+Markdown preview comes to the liquid-glass note: click text to edit, then click elsewhere to return to the formatted note.
+
+- **Automatic switching**: notes start in preview. Clicking text opens source editing; clicking blank space, a control or another window saves and restores preview. Pausing typing does not leave editing.
+- **Markdown formatting**: headings, bold, italic, strikethrough, ordered/unordered lists, tasks, quotes, inline/fenced code and link labels.
+- **Native editing**: retains Chinese input, source-position-aware caret placement and undo history. Preview waits for IME composition to finish. Empty notes remain clickable for input.
+- **Glass presentation**: text wraps to the note width, follows font-size changes and remains readable over transparent backgrounds. Preview can be scrolled.
 
-- **Automatic text color** follows the rendered background, with smooth transitions and hysteresis to reduce flicker.
-- **Adaptive monochrome controls** follow the surrounding background. Close retains red hover feedback; the resize hint follows text color.
-- **Glass lighting** responds to local background color and texture.
-- **Interaction improvements** reuse shaders and graphics resources during collapse/restore, reveal controls sooner, and remove a window-count limit from control stacking.
+Content remains Markdown source in `data/note.txt`, and existing plain-text notes continue to work. Clicking a link or task marker edits its source. Tables, images and HTML are not rendered; no remote content is loaded. This is a subset of common Markdown syntax, not a complete CommonMark/GFM implementation.
 
 Download a ZIP from Assets: **x64 for most PCs**, arm64 for Windows on ARM, or x86 for 32-bit environments. Extract and run `FloatNote.exe`; no additional runtime is required.
 
 Exit before upgrading, replace the EXE, and **keep and back up the existing `data` folder**. Packages contain no personal data. Verify downloads with `SHA256SUMS.txt`.
 
-Liquid glass targets supported Windows 11 environments. Some capture and remote-sharing methods still omit live glass; use frosted glass when needed. This release does not resolve that limitation. Settings/material panels remain in Chinese. Binaries are unsigned. Automated tests do not certify every GPU or remote environment.
+Liquid glass targets supported Windows 11 environments. Some capture and remote-sharing methods omit live glass; use frosted glass when needed. Settings/material panels remain in Chinese. Binaries are unsigned. Automated checks do not certify every IME, GPU or remote environment.
@@ -12,11 +12,13 @@ For the liquid-glass renderer, source map and adaptation boundaries, start with
 - `src/liquid_backdrop.h` and `monitor_backdrop_capture.h` — local GPU material and monitor capture.
 
 - `src/main.cpp` — Win32 window, input, persistence, tray, and rendering behavior.
+- `src/markdown.h` / `src/markdown_preview.h` — local Markdown parsing, source-position mapping and DirectWrite/Direct2D preview; native EDIT retains input, IME and undo.
 - `src/backdrop.h` — isolated Windows Composition host-backdrop integration.
 - `src/platform.h` — small Windows helpers and atomic file writes.
 - `src/localization.h` — English and Simplified Chinese strings.
 - `src/version.h` / `src/resources.rc` — the single product version and executable metadata.
 - `tests/regression.cpp` — hidden, deterministic native behavior checks.
+- `tests/glass_markdown.cpp` — automatic preview/edit switching, source persistence, undo, IME lifecycle, wrapping and transparent text composition with isolated data.
 - `tests/integration.cpp` — focused compositor and interaction checks that open temporary windows.
 - `tests/visuals.cpp` — shadow, tint, text antialiasing, custom text color, and settings screenshot checks.
 - `tests/visual_test_support.h` — shared fixtures and compositor capture helpers.
 
@@ -1,4 +1,4 @@
-# FloatNote 2.0 — 快速开始 / Quick start
+# FloatNote 2.2.0 — 快速开始 / Quick start
 
 1. 解压 ZIP 到可写目录，双击 FloatNote.exe。无需编译源码。
 2. 鼠标移到便签顶部提示附近，进入设置；右下角拖动调整大小。
@@ -7,10 +7,16 @@
 5. 升级前退出旧版，只替换 EXE，保留 data 文件夹；建议先备份 data。
 6. 截图或远程看不到便签时，在设置里切换毛玻璃。
 
+便签默认预览 Markdown。点击文字进入原文编辑，点击空白、操作控件或切到其他窗口后自动保存并回到预览；仅暂停打字不会退出编辑。空便签点击文字区域即可输入。
+支持标题、粗体、斜体、删除线、有序/无序列表、任务列表、引用、行内代码、围栏代码块和链接文字。链接和任务标记点击后进入编辑。内容仍按 Markdown 原文保存在本地 `data/note.txt`，普通文本照常使用；表格、图片和 HTML 暂按原文显示，不加载远程内容。
+
 Extract the ZIP into a writable folder and run FloatNote.exe. No build step is needed.
 Hover near the top hint for settings; resize with the bottom-right grip. Shrink vertically to tuck the note away, and click the remaining bar to restore it.
 Ctrl+Alt+E restores editing, Ctrl+Alt+H toggles visibility, and Ctrl+Alt+P toggles click-through. Running the app again also restores the note.
 Exit before upgrading, replace the EXE and keep your data folder. Use frosted glass when screenshot/remote visibility is needed.
 The new settings panel is currently in Chinese. Binaries are unsigned; checksums are provided on the release page.
 
+Notes start in Markdown preview. Click text to edit its source; click blank space, a control, or another window to save and return to preview. Pausing typing does not leave editing. Click anywhere in an empty note's text area to start writing.
+Headings, emphasis, strikethrough, lists, tasks, quotes, inline/fenced code and link labels are supported. Clicking a link or task marker edits its source. Markdown remains in `data/note.txt`; plain text still works. Tables, images and HTML are shown as source, with no remote content loading.
+
 Downloads / feedback: https://github.com/Fryingpan-Jason/FloatNote-Liquid-Glass/releases/latest
@@ -206,6 +206,7 @@ HRESULT CALLBACK ExperienceCloseDialogProcedure(HWND window,UINT message,WPARAM,
 }
 void RequestExperienceClose() {
     if(!experienceReady || g_closing || experienceCloseDialogOpen || experienceColorDialogOpen || experienceColorRequestPending)return;
+    LeaveMarkdownEditor();
     experiencePanel.Close(false);
     auto decision=GlassClose::Resolve(experienceCloseBehavior,GlassClose::Behavior::Ask,false,false);
     if(experienceCloseBehavior==GlassClose::Behavior::Ask) {
@@ -401,6 +402,7 @@ void TickExperienceAbsorb() {
 void CloseExperienceMenu() {if(experienceReady)experiencePanel.Close();}
 void ToggleExperienceMenu() {
     if(ExperienceInputBlocked() || experienceCloseDialogOpen || experienceColorDialogOpen || experienceColorRequestPending)return;
+    LeaveMarkdownEditor();
     if(!experienceReady)CreateExperienceUI();
     if(!experienceReady)return;
     if(experienceFolded){ExpandExperienceNote();return;}
@@ -417,6 +419,7 @@ void ToggleExperienceMenu() {
     SyncExperienceUI();
 }
 void ExperienceAction(GlassControlPopover::Action action,int value) {
+    LeaveMarkdownEditor();
     using A=GlassControlPopover::Action;
     switch(action){
     case A::ToggleTopmost:SetTopmost(!ExperienceState().pinned);break;
@@ -483,7 +486,7 @@ void CreateExperienceUI() {
     experienceIsland.Create(g_instance,[]{ToggleExperienceMenu();},[](int,int){
         if(experienceDragging){experienceDragging=false;RecoverWindowPosition();SaveSettings();SyncExperienceUI();}
     },[](int dx,int dy){
-        if(!experienceDragging){GetWindowRect(g_window,&experienceDragOrigin);experienceDragging=true;CloseExperienceMenu();}
+        if(!experienceDragging){LeaveMarkdownEditor();GetWindowRect(g_window,&experienceDragOrigin);experienceDragging=true;CloseExperienceMenu();}
         SetWindowPos(g_window,nullptr,experienceDragOrigin.left+dx,experienceDragOrigin.top+dy,0,0,
             SWP_NOSIZE|SWP_NOZORDER|SWP_NOACTIVATE);
     },[]{PostMessageW(g_window,kExperienceCloseRequest,0,0);});