# Jaspr Convert HTML

> Use when you need to convert / rewrite existing HTML (from a file or url) into Jaspr code.

- Skill: `rodydavis/jaspr-convert-html` (Agent Skill)
- Install (CLI): `npx skillmds@latest add rodydavis/jaspr-convert-html`
- Raw SKILL.md: https://api.skillmd.com/api/skills/rodydavis/jaspr-convert-html/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: rodydavis (https://skillmd.com/u/rodydavis)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/rodydavis/jaspr-convert-html

---


## Rules

Converting existing HTML into Jaspr component syntax by hand is prone to errors and wastes time.

- **Rule 1:** You MUST ALWAYS use the `jaspr convert-html` command to convert existing HTML.
- **Rule 2:** You MUST NEVER attempt to convert HTML to Jaspr code manually.
- **Rule 3:** You MUST take the output from the daemon UNCHANGED and use it exactly as provided.

## Usage

To convert HTML to Jaspr code, run one of the following commands in the terminal depending on your source:

**From a local file:**
```bash
jaspr convert-html --file some/path/to/file.html
```

**From a URL:**
```bash
jaspr convert-html --url https://example.com
```

The resulting Jaspr code is printed directly to the console. You can then copy this code directly into your component's `build` method.

### Selecting Specific Elements

If you only need a portion of the HTML, you MUST use the `--query` option with a CSS selector to target specific elements rather than converting the whole file and deleting pieces manually.

```bash
jaspr convert-html --file some/path/to/file.html --query "#my-id"
```
*This will only convert and output the element with the id `my-id`.*

**Tip:** To convert everything inside the `<body>` tag but exclude the `<body>` tag itself, use:
```bash
jaspr convert-html --file some/path/to/file.html --query "body > *"
```
