# 缩进列表转 ASCII 目录树

把 2 空格 / 4 空格 / Tab 缩进的层级列表（Markdown bullet、- * 1. 前缀可选）渲染为可复制的 ASCII 目录树。支持 Unicode 方框与经典 ASCII 两种风格，以及整根纵线、行尾空格、叶节点方括号等开关。

> 标准页面: https://elysiatools.com/zh/tools/ascii-tree-from-indented-list

- **分类:** Text Processing

- **关键词:** ASCII 目录树, 目录树, 缩进列表, 文件夹树, 树状结构, Unicode 方框, 文件树, README 树, 项目结构, 可复制树

## 概述

把普通的缩进大纲变成干净、可直接复制粘贴的目录树——就像写得好的 README 顶部那种。

**工作原理。** 粘贴任何使用 2 空格、4 空格或 Tab 缩进的层级列表。Markdown 列表前缀（`-`、`*`、`+`、`1.`）可选，会自动剥除；空行被忽略。解析器自动检测最常见的缩进单位，也可以强制指定。结果用标准的树形连接符渲染。

**两种输出风格。**
- **Unicode 方框**（`├── └── │`）——现代默认值，在 GitHub、Discord、VS Code 和大多数终端里很好看。
- **经典 ASCII**（`|-- `-- |`）——完全没有 Unicode，适用于纯文本邮件、老旧终端和仅 ANSI 环境。

**三个开关。**
- *画整根纵线*——把竖线 `│` 一直画到底，让父节点视觉上对齐；关掉则更紧凑。
- *叶节点加方括号*——给文件套上 `[]`，例如 `docs/[api.md]`，这是 `tree` 和很多文档的惯例。
- *去除行尾空格*——去掉最后一个连接符后残留的空格，diff 更干净、粘贴更小。

**为什么不用 `tree` 命令行。** `tree` 只能扫描你磁盘上真实存在的文件夹。本工具处理*任何*缩进文本——大纲、头脑风暴、Markdown 规格、Notion 导出——并在浏览器里直接选风格。

## 输入项

- **缩进列表** (textarea): src index.ts tools json-formatter.ts qr-code-generator.ts package.json
- **风格** (select)
- **缩进单位** (select)
- **画整根纵线** (checkbox)
- **叶节点加方括号** (checkbox)
- **去除行尾空格** (checkbox)

## 适用场景

- 在编写 GitHub 项目的 README.md 文档，需要展示清晰的项目目录结构时。
- 将 Notion 导出、Markdown 大纲或头脑风暴的缩进文本快速转换为可视化树状图时。
- 需要在纯文本邮件、老旧终端或不支持 Unicode 的 ANSI 环境中展示文件层级时。

## 工作原理

- 在输入框中粘贴使用 2 空格、4 空格或 Tab 缩进的层级列表，系统会自动识别并剥除 Markdown 列表前缀（如 -、*、1.）。
- 选择所需的输出风格（现代 Unicode 方框或经典 ASCII 字符）并指定缩进单位（或使用自动检测）。
- 根据需要勾选“画整根纵线”、“叶节点加方括号”或“去除行尾空格”等辅助配置。
- 工具在浏览器中实时解析并生成对应的树状结构文本，点击即可一键复制。

## 使用案例

- 编写开源项目 README 文档中的目录结构说明。
- 将 Notion 或 Markdown 的大纲笔记转换为可视化的树状图。
- 在技术文档或邮件中插入清晰的文件层级关系。

## 常见问题

### 这个工具支持哪些缩进格式？

支持 2 空格、4 空格以及 Tab 缩进。工具会自动检测缩进单位，您也可以手动指定。

### 列表前面的 Markdown 符号（如 - 或 *）需要手动删除吗？

不需要。工具会自动识别并剥除 Markdown 列表前缀（如 -、*、+、1.），只保留文本内容。

### 什么是“叶节点加方括号”功能？

开启该功能后，树状图末端的叶子节点（通常是文件）会被方括号包裹，例如 [index.ts]，这是传统 tree 命令的常见输出格式。

### 经典 ASCII 风格和 Unicode 风格有什么区别？

Unicode 风格使用 ├── 和 └── 等现代字符，在 GitHub 和现代编辑器中显示更美观；经典 ASCII 风格使用 |-- 和 \--，适合不支持 Unicode 的老旧终端或纯文本邮件。

### 这个工具会上传我的目录数据到服务器吗？

不会。所有文本解析和目录树生成均在您的浏览器本地完成，不会上传任何数据，确保隐私安全。

## 相关工具

- [Data URI 生成器](https://elysiatools.com/zh/tools/data-uri-generator): 将文件转换为 Data URI（Base64 或百分号编码），用于直接在 HTML、CSS 或 Markdown 中内联图片、字体等资源
- [颠倒文字](https://elysiatools.com/zh/tools/upside-down-text): 用逐字母旋转把文字颠倒（ɥǝllo），并提供可选开关保留阅读顺序、保护链接/邮箱不被搅乱。纯 Unicode 文本，无需字体。比聚合器里固定行为的颠倒行更可控。
- [AI图片转Markdown](https://elysiatools.com/zh/tools/ai-image-to-markdown): 使用AI视觉模型从图片中提取文本并转换为Markdown格式
- [加粗斜体文本](https://elysiatools.com/zh/tools/bold-italic-text): 用 Mathematical Alphanumeric Symbols Unicode 区把文本转为加粗、斜体或粗斜体。纯 Unicode 文本，无需字体。
- [图最短路径计算器（Dijkstra 手算辅助）](https://elysiatools.com/zh/tools/graph-shortest-path): Dijkstra 最短路径的手算辅助工具：输入 1–30 条边（每行：起点、终点、权重）与起点/终点，默认无向、可切换有向。逐轮记录“定居哪个节点、距离多少、每次松弛如何更新临时距离表”，平局按字典序取最小节点名，日志与教科书演算完全一致；负权重按业务拒绝，终点不可达作为合法结果报告。经典例：A-B 4、A-C 2、B-C 5、B-D 10、C-E 3、D-E 4、D-F 11、E-F 8，从 A 到 F → 最短距离 13，路径 A→C→E→F。
- [Markdown 列表格式化器](https://elysiatools.com/zh/tools/markdown-list-formatter): 将每行文本转换为 Markdown 列表项或数字列表
- [PDF转Markdown转换器](https://elysiatools.com/zh/tools/pdf-to-markdown): 将PDF文档转换为Markdown格式，支持文本提取和格式保留
- [Markdown 规范与风格检查器](https://elysiatools.com/zh/tools/markdown-lint-style-checker): 按约 15 条 markdownlint 规则加 2 条中文排版规则检查 Markdown，给出带行号的问题清单，并可一键自动修复安全项

## 示例

- [Markdown 示例](https://elysiatools.com/zh/samples/markdown-samples): Markdown 格式示例，从简单到复杂的文档结构
- [Markdown 查看器样本](https://elysiatools.com/zh/samples/markdown-viewer-samples): 用于 README 预览、文档渲染和富文本标记测试的 Markdown 样本文件
- [PDF示例](https://elysiatools.com/zh/samples/pdf-samples): 2026-02-01 到 2026-02-10 工具生成的PDF示例
- [Test Pyramid Examples - 测试策略指导](https://elysiatools.com/zh/samples/test-pyramid-examples): 全面的测试金字塔实现示例，包括单元测试、集成测试、端到端测试、测试组织和平衡软件质量保证的战略测试模式

## 相关内容

- [结构与逻辑图生成器](https://elysiatools.com/zh/hubs/structural-and-logic-diagram-generators): 从文本、JSON、集合定义或日志生成流程图、思维导图、组织架构图、树状图、韦恩图、ASCII 目录树与时序图。