new-md

---
name: new-md
description: Create a fresh, empty markdown file in the project root (or a subfolder)
---

# new-md — Create an empty markdown file

## Arguments

Parse from user input: `[name] [in <subfolder>]`

Examples:
- `/new-md introduction` → creates `introduction.md` in project root
- `/new-md methods in paper/` → creates `methods.md` in `paper/` subfolder
- `/new-md observations in notes` → creates `observations.md` in `notes/` subfolder
- `/new-md` → no name provided (see below)

## Behavior

1. **Parse name**: extract the markdown file name from the arguments. Do not add `.md` if the user already included it. Add `.md` if they didn't.
2. **Parse subfolder** (optional): if the user provides a subfolder (via "in <folder>", "under <folder>", or similar phrasing), use that as the directory. If the subfolder doesn't exist, create it. Default location is the project root (current working directory).
3. **If no name is provided**: ask the user for a name. If the user declines or says "you pick", generate a sensible name based on recent conversation context.
4. **Create the file**: write an empty file at the resolved path. The file must be empty — no boilerplate, no headers, no template content.
5. **Confirm**: report the created file path in one line.

## Rules

- Never overwrite an existing file. If the file already exists, tell the user and stop.
- Use underscores for multi-word names (e.g., `high_level_idea.md` not `high-level-idea.md`) unless the user specifies otherwise.
- The subfolder path is relative to the project root.