Free tool · works now

Folder Structure Visualizer

Visualize note vault folders as ASCII, Unicode, or Markdown outline trees with depth metrics and shell scripts.

Runs 100% in your browser. Turn lists of file paths into readable Unicode box trees, Markdown outlines, or reproducible directory skeleton scripts.

23Files cataloged
18Directories
4Max folder depth
4Hidden items
File extension breakdown:
.md: 12 (52.2%).pdf: 3 (13%).png: 2 (8.7%).json: 2 (8.7%).svg: 1 (4.3%).m4a: 1 (4.3%).js: 1 (4.3%).css: 1 (4.3%)
Vault file & folder path listOne relative path per line

Paste file paths from terminal (find . -type f), text manifests, or file lists. Slashes or backslashes are normalized automatically.

Formatted directory treeReady to copy into Markdown docs
.
├── .obsidian/
│   ├── plugins/
│   │   └── dataview/
│   │       └── main.js
│   ├── themes/
│   │   └── minimal.css
│   ├── app.json
│   └── workspace.json
├── attachments/
│   ├── audio/
│   │   └── meeting-standup.m4a
│   ├── diagrams/
│   │   ├── network-topology.svg
│   │   └── system-architecture.png
│   └── screenshots/
│       └── modal-bug.png
├── notes/
│   ├── archive/
│   │   └── 2025/
│   │       ├── retrospective.md
│   │       └── tax-returns.pdf
│   ├── personal/
│   │   ├── health/
│   │   │   ├── annual-checkup.pdf
│   │   │   └── running-log.md
│   │   └── reading-list-2026.md
│   └── work/
│       ├── client-marqly/
│       │   ├── interviews/
│       │   │   ├── cto-transcript.md
│       │   │   └── lead-architect.md
│       │   ├── contract-signed.pdf
│       │   └── q3-strategy.md
│       └── operations/
│           ├── incident-response.md
│           └── onboarding-playbook.md
├── templates/
│   ├── daily-note-template.md
│   └── meeting-record-template.md
├── LICENSE.md
└── README.md

Instant visual representation. Use the style options above to toggle between Unicode, ASCII, and Markdown list formats.

Why Visualizing Folder Structure Matters for Knowledge Management

Over months and years of active note-taking, Markdown vaults tend to expand organically. What begins as a clean, minimal collection of project notes gradually accumulates auxiliary folders, meeting transcripts, archived drafts, template directories, and media attachment assets. Without a clear structural overview, note collections develop structural blind spots: duplicate folder hierarchies, excessively deep directory nesting, or orphaned categories that fragment knowledge retrieval.

The Folder Structure Visualizer converts any arbitrary list of relative file and directory paths into a clear, bounded hierarchical tree. By processing everything locally inside your browser memory, it provides immediate visibility into your vault's architectural layout without sending confidential folder names or research topics to cloud servers.

The Deep Nesting Trap versus Flat Categorization

In knowledge organization methodologies like PARA (Projects, Areas, Resources, Archives) or Johnny Decimal, one of the most common organizational errors is excessive directory depth. When note folders are nested four, five, or six layers deep (e.g. work/clients/acme/projects/redesign/interviews/notes.md), cognitive friction escalates dramatically:

Using the max depth metric and depth filter in this visualizer allows you to audit folder complexity at a glance. Most high-velocity vaults benefit from keeping core note hierarchies at a maximum depth of two to three levels, relying on bidirectional relative links and tags for multidimensional connections rather than deep folder silos.

Choosing the Right Tree Representation Style

Different documentation contexts call for different structural visual representations:

  1. Unicode Box Drawing (├──, └──): The modern standard for technical specifications, user manuals, and GitHub documentation. Characters like ├── and └── provide high visual contrast and intuitive branch guidance.
  2. ASCII Tree (|--, \--): Necessary when outputting to plain text emails, legacy terminal consoles, or code files where UTF-8 box characters may be misinterpreted or stripped.
  3. Markdown Bullet List (- folder/): Formats the hierarchy as nested unordered lists. This format can be pasted directly into Obsidian or any CommonMark editor as an interactive table of contents or folder MOC (Map of Content).
  4. Indented Hierarchy: Four-space indented plain text, ideal for configuration manifests or custom YAML directory templates.

Replicating Directory Skeletons with Shell Scripts

When onboarding team members, sharing a project template, or creating automated backup architectures, you often need to reproduce an entire directory structure without copying actual note contents or confidential client documents.

The visualizer's Export skeleton shell script feature analyzes your path list and generates safe mkdir -p commands. Every directory path is carefully escaped to prevent shell injection, allowing you to run the script in any Unix, macOS, or WSL terminal to stand up an identical directory skeleton in seconds.

Auditing File Extension Distributions

Note collections rarely contain only Markdown text. A healthy vault frequently includes vector graphics, photographic attachments, PDF reference manuals, audio recordings, and canvas files. The extension distribution ribbon summarizes the composition of your vault, highlighting:

Step-by-Step Vault Structure Audit Protocol

  1. Generate your path list: In your terminal, navigate to your vault root and run find . -not -path '*/.*' > manifest.txt (or include hidden files with find .). Copy the resulting list.
  2. Paste into the visualizer: Paste the text into the input panel above. The tree and statistics render instantaneously.
  3. Inspect folder depth and hierarchy: Review the max folder depth stat. If subdirectories extend beyond level 3, consider flattening the structure.
  4. Review extension distribution: Check the file type breakdown to verify attachment ratios and file types.
  5. Copy for team documentation: Switch to Unicode or Markdown list style, click Copy tree text, and embed the layout into your project README.

Questions

How does the Folder Structure Visualizer parse my vault paths?

The engine splits each relative path by directory separators (/ or \), cleans leading and trailing slashes, and builds an in-memory hierarchical directory tree. It tracks immediate files, recursive subdirectory file counts, depth levels, and file extensions, then renders the tree using deterministic Unicode box characters or Markdown outlines.

Can I visualize my vault without including hidden configuration files?

Yes. Toggle the "Include hidden files" option off to instantly exclude dotfiles and dotfolders (such as .obsidian/, .trash/, .git/, and .DS_Store). This produces clean, distraction-free diagrams suitable for sharing in team documentation and READMEs.

What is the purpose of the bash skeleton script export?

The skeleton script generates mkdir -p shell commands for every folder identified in your hierarchy. This allows you to replicate your entire vault directory structure in a fresh location or test environment without copying confidential notes or media files.

How does the max depth filter work for large or deeply nested note collections?

When managing vaults with hundreds of nested subdirectories, rendering all levels at once can create unwieldy diagrams. Setting max depth to 1, 2, or 3 truncates deeper traversal, providing a clean high-level architectural overview of top-level categories without overwhelming detail.

Why are spreadsheet formula guards applied to the folder CSV export?

If a directory or filename begins with dangerous formula trigger characters (=, +, -, @, or tabs), opening an unescaped CSV in Microsoft Excel or Google Sheets could execute arbitrary spreadsheet code. The visualizer prefixes such entries with a single apostrophe to guarantee complete safety.

Does this tool upload my folder structure or file names to a remote server?

No. The entire tree generation algorithm, formatting engine, extension distribution calculation, and script builder run exclusively within your browser tab. Zero network requests or telemetry events are transmitted.

Organize your Markdown vault with clarity

Private on-device text intelligence and native Markdown editing in Oyma. Keep your note hierarchy clean and portable across devices.

tools folder structure visualizer downloadDownload for Mac

No account needed. Intel Mac build