# Run with options
genaiscript run translate --vars targetLanguage=French
```

## Limitations

[Section titled “Limitations”](#limitations)

* No direct JavaScript/TypeScript code execution
* Limited dynamic content generation
* Variable interpolation requires external processing
* Cannot use GenAIScript functions directly (like `def()`, `env.files`, etc.)

## When to Use Markdown Scripts

[Section titled “When to Use Markdown Scripts”](#when-to-use-markdown-scripts)

Markdown scripts are ideal for:

✅ **Simple prompts** with static content\
✅ **Non-technical users** who prefer markdown\
✅ **Documentation-heavy** prompts\
✅ **Template-based** interactions\
✅ **Quick prototyping** of prompt ideas

For complex logic, file processing, or dynamic content generation, use JavaScript/TypeScript `.genai.mts` files instead.

## Migration from JavaScript

[Section titled “Migration from JavaScript”](#migration-from-javascript)

You can easily convert simple JavaScript scripts to markdown:

**Before** (JavaScript):

explain.genai.mts

```javascript
script({
title: "Code Explainer",
description: "Explains code functionality"
})


$`# Code Explanation


Please explain the following code:
- What does it do?
- How does it work?
- Are there any potential issues?`
```

**After** (Markdown):

explain.genai.md

```markdown
---
title: "Code Explainer"
description: "Explains code functionality"
---