编辑面

所见即所得的写作体验

输入的瞬间就是最终的样子。标题加粗、列表缩进、引用缩进、代码高亮——一切都在同一个编辑面上完成,不需要在预览和源码之间来回切换。

  • 标题(H1–H6)、粗体、斜体、删除线、下划线
  • 有序列表、无序列表、可嵌套的任务列表
  • 引用块、分割线、文字颜色与高亮标记
  • 表格支持调整列宽,左中右对齐
  • 一键切换源码视图,随时查看 Markdown 本身

接口设计文档

用户认证

使用 Bearer Token 进行身份验证,令牌有效期为 24 小时。

  • 登录接口返回 JWT 令牌
  • 后续请求在 Header 中携带 Authorization
  • 令牌过期后需重新登录
注意:测试环境的令牌有效期缩短为 2 小时。

响应格式

所有接口统一返回 JSON 格式。

命令系统

斜杠即命令

在任何空行敲下斜杠,命令面板就会浮在光标旁。不需要记住快捷键,也不需要翻菜单——输入关键词就能找到你要的内容块。

  • 三大分组:基础、列表与内容、媒体与链接
  • 中英文混合搜索,用习惯的叫法就能找到
  • 键盘导航:方向键选择,回车确认,ESC 取消
  • 可选显示命令辅助说明
文本一级标题heading1无序列表任务列表todo引用代码块表格分割线插入图片插入视频插入文件超链接

把光标放在这里,输入 / 试试——

/代码块

/ 输入以搜索… ESC
基础
文本
H1一级标题
列表与内容
任务列表
</>代码块语法高亮
表格
img插入图片

导航

大纲与文件树,随时在手边

打开一份文档,同级目录的 Markdown 文件自动列在侧栏。切换到大纲标签,标题层级一目了然,点一下就能跳到对应位置。

  • 文件树按需展开子目录,不一次性遍历整个目录
  • 大纲实时反映标题层级,代码块里的注释不会误判
  • 项目名自动从目录路径提取,显示文件和目录计数
  • 快捷键 Ctrl+B 随时收起或展开侧栏
api-design.md

API 设计文档

用户认证

使用 Bearer Token 进行身份验证。

登录接口

POST /api/auth/login

结构

想清楚一段,就挪动一段

把光标移到任意段落左侧,拖拽柄就会出现。拖动一块到新位置,整段连同格式一起搬走;拖动标题,它身后的整个章节跟着移动。

  • 块级拖拽:段落、列表、引用、代码块都能拖
  • 拖动标题时连同下属章节一起移动
  • 章节折叠:点击标题旁的箭头收起整段内容
  • 拖拽时显示蓝色落点指示线,位置一目了然

本周进展

接口联调完成 80%,剩余两个边界场景在本周五前补齐。

用户认证模块已通过验收。

下周计划 (已折叠)

代码高亮

代码也是正文的一部分

每个代码块都能单独选择语言、一键复制。四种窗口外观,换一种立刻生效。

typescript
interface User {
  id: string
  name: string
}
const user: User = {
  id: '1',
  name: 'XMD'
}
经典窗口
熟悉的桌面代码窗口
bash
# 安装并启动
cd ~/projects/notes
xmd .

# 构建生产版本
xmd build --prod
终端绿
高对比度的命令行质感
python
def parse_headings(text):
    return [
        l for l in text.split('\n')
        if l.startswith('#')
    ]
纸张浅色
适合明亮环境与长时间阅读
rust
fn main() {
    let editor = Editor::new()
        .theme("dark")
        .build();
    editor.run();
}
午夜蓝
冷静、清晰的深蓝配色
JavaScriptTypeScriptPythonRustGoJavaKotlinSwiftCC++C#SQLBashShellYAMLJSONHTML / XMLCSSSCSSLessMarkdownGraphQLLuaPerlRObjective-CVB.NET

快捷键

每个快捷键都能自定义

在设置中点击按键组合,直接输入新的快捷键。不满意随时恢复默认。

新建文档
创建一个空白 Markdown 文档
Ctrl+N
打开文档
从本地选择并打开文档
Ctrl+O
保存文档
保存当前文档的修改
Ctrl+S
显示 / 隐藏侧边栏
切换项目文件与大纲面板
Ctrl+B
切换编辑模式
在 MD 预览和源码展示间切换
Ctrl+/
打开设置
打开应用设置中心
Ctrl+,

功能总览

完整的写作工具集

所见即所得

输入即呈现,无需切换预览。

斜杠命令

输入「/」调用全部内容块。

实时大纲

标题层级自动生成,点击跳转。

本地文件树

同级文档自动列出,按需展开。

块拖拽重排

拖动段落或整个章节到新位置。

章节折叠

收起不需要的章节,专注当前。

代码高亮

28+ 种语言,四种窗口外观。

多文档标签

同时打开多份文稿,标签切换。

主题切换

浅色、深色、跟随系统。

自定义快捷键

每个快捷键都能改成你的习惯。

资源归位

图片和附件自动保存到指定目录。

本地优先

文档始终在本地,无需账号。

准备好了吗?

免费下载 XMD,开始你的 Markdown 写作。

免费下载