Skip to content

About astro-content-ai-enhancer

AI assistant for Astro content collections. Takes raw Markdown from your content/ directory and turns it into structured, well-formatted pages with richer layout and blocks — while keeping the original voice intact.

Features

Content Enhancement

Transform rough drafts into polished articles:

  • Add proper headings and structure
  • Insert appropriate formatting
  • Create lists, tables, and callouts
  • Improve readability and flow

Layout Improvement

Better visual organization:

  • Section breaks where appropriate
  • Logical content grouping
  • Visual hierarchy through formatting
  • Consistent styling patterns

Voice Preservation

The most important feature — your voice stays yours:

  • Tone is maintained
  • Writing style is preserved
  • Opinions aren’t changed
  • Only structure is enhanced

Non-Destructive

Original content remains accessible:

  • Enhanced versions are separate
  • Easy to compare changes
  • Rollback if needed
  • Audit trail of modifications

How It Works

# Install the tool
npm install astro-content-ai-enhancer

# Enhance a single file
npx enhance-content ./src/content/pages/article.mdx

# Batch enhance
npx enhance-content ./src/content/pages --batch

Example

Before:

# My Article

This is about affiliate marketing. There are many networks.
Some are good and some are bad. You should look at
commission rates and also payment terms. Support matters too.

After:

# My Article

This is about affiliate marketing.

## Network Quality

There are many networks — some good, some bad. When evaluating them, consider:

- **Commission rates** — The percentage you earn
- **Payment terms** — When and how you get paid
- **Support quality** — How responsive they are

Each factor matters for your long-term success.

Same message, better presentation.

Configuration

// enhancer.config.js
export default {
  contentDir: './src/content/pages',
  // Enhancement level
  level: 'moderate', // 'light' | 'moderate' | 'heavy'
  // What to enhance
  addHeadings: true,
  addLists: true,
  addTables: true,
  addCallouts: true,
  // Voice settings
  preserveVoice: true,
  maintainLength: true
}

Use Cases

Converting Notes to Articles

Got rough notes from research? The enhancer structures them into readable articles without changing your findings.

Standardizing Formats

Multiple authors, inconsistent styles? Batch enhance to create visual consistency while preserving individual voices.

Legacy Content Upgrades

Old content that’s valuable but poorly formatted? Enhance it for modern presentation.

Bulk Content Processing

Large content migrations? Process hundreds of files while maintaining quality.

Why We Built It

Quality content takes time. For comprehensive review sites with thousands of entries, manual formatting of every page isn’t practical. This tool helps scale content production without sacrificing structure or readability.

It’s not about replacing writers — it’s about amplifying their output.

Limitations

  • Works best with text content (not image-heavy layouts)
  • Some manual review recommended
  • Very creative content may need lighter enhancement

Open Source

Full source available on GitHub. Contributions and feedback welcome.