Skip to main content

LLM Content Generation Prompt

Use this prompt when asking an LLM (ChatGPT, Claude, etc.) to generate blog content for your platform.

Prompt Template​

Please generate a blog post in the following JSON format:

{
  "title": "string (required)",
  "slug": "string (required, URL-friendly)",
  "subtitle": "string (optional)",
  "excerpt": "string (optional, 150-200 chars)",
  "content_type": "blog | tutorial | lesson | tip | case_study",
  "access_level": "public | registered | premium | course_specific",
  "difficulty_level": "beginner | intermediate | advanced",
  "tags": ["array", "of", "strings"],
  "featured_image": "string (optional, must be valid URL)",
  "video_url": "string (optional, must be valid URL)",
  "meta_title": "string (optional, max 60 chars)",
  "meta_description": "string (optional, max 160 chars)",
  "content": {
    "type": "doc",
    "content": [
      // Array of content blocks (see below)
    ]
  }
}

IMPORTANT: The content field must use TipTap/ProseMirror JSON format with these node types:
- heading (with level 1-6)
- paragraph
- bulletList & orderedList (with listItem children)
- blockquote
- codeBlock (specify language attribute)
- image (single image)
- imageGallery (multiple images with captions)
- videoEmbed (YouTube, Vimeo, or MP4 URLs)
- mermaidDiagram (for flowcharts, sequence diagrams, etc.)
- table

Use camelCase for all node types (bulletList NOT bullet_list).

Topic: [YOUR TOPIC HERE]
Content Type: [blog/tutorial/lesson/tip]
Difficulty: [beginner/intermediate/advanced]
Length: [short/medium/long]

Please include:
- Multiple paragraphs with bold and italic text
- At least one code example (use codeBlock with language)
- Bullet points or numbered lists where appropriate
- A relevant image gallery (2-3 images with captions)
- Consider adding a mermaid diagram if it helps explain concepts

Example Request​

Please generate a blog post about "Introduction to AI Agents" in the JSON format specified above.

Topic: Introduction to AI Agents
Content Type: tutorial
Difficulty: beginner
Length: medium

Please include:
- An explanation of what AI agents are
- A code example showing a simple agent implementation
- A flowchart diagram showing how AI agents work
- An image gallery with 3 relevant AI images
- Bullet points listing key benefits

Available Content Types​

1. Basic Text​

{
  "type": "paragraph",
  "content": [
    { "type": "text", "text": "Regular text" },
    { "type": "text", "marks": [{"type": "bold"}], "text": "Bold text" },
    { "type": "text", "marks": [{"type": "italic"}], "text": "Italic text" }
  ]
}

2. Code Block (Enhanced)​

{
  "type": "codeBlock",
  "attrs": { "language": "python" },
  "content": [
    { "type": "text", "text": "def hello():\n    print('Hello World')" }
  ]
}

Supported languages: javascript, typescript, python, java, csharp, cpp, go, rust, php, ruby, swift, kotlin, html, css, json, yaml, sql, bash, markdown

3. Image Gallery ✨ NEW​

{
  "type": "imageGallery",
  "attrs": {
    "images": [
      {
        "url": "https://example.com/image1.jpg",
        "alt": "Description for accessibility",
        "caption": "Optional caption text"
      },
      {
        "url": "https://example.com/image2.jpg",
        "alt": "Another description",
        "caption": "Another caption"
      }
    ]
  }
}

4. Video Embed ✨ NEW​

{
  "type": "videoEmbed",
  "attrs": {
    "url": "https://www.youtube.com/watch?v=VIDEO_ID",
    "caption": "Video explanation of the concept",
    "width": 640,
    "height": 360
  }
}

Supports: YouTube, Vimeo, direct MP4/WebM files

5. Mermaid Diagram ✨ NEW​

{
  "type": "mermaidDiagram",
  "attrs": {
    "code": "graph TD\n    A[Start] --> B[Process]\n    B --> C[Decision]\n    C -->|Yes| D[End]\n    C -->|No| A"
  }
}

Diagram types: flowchart, sequence, class, state, gantt, pie, etc.

6. Lists​

{
  "type": "bulletList",
  "content": [
    {
      "type": "listItem",
      "content": [
        {
          "type": "paragraph",
          "content": [{"type": "text", "text": "First item"}]
        }
      ]
    }
  ]
}

7. Headings​

{
  "type": "heading",
  "attrs": { "level": 2 },
  "content": [{"type": "text", "text": "Section Title"}]
}

Tips for Best Results​

  1. Be Specific: Tell the LLM exactly what you want (topic, length, style)
  2. Request Examples: Ask for code blocks, diagrams, or image galleries
  3. Specify Format: Remind the LLM to use camelCase (bulletList not bullet_list)
  4. Validate Output: Check that the JSON is valid before importing
  5. Iterate: If the output isn't perfect, ask the LLM to refine specific sections

Quick Start Example​

Copy this entire message to ChatGPT/Claude:

Generate a blog post about "Building Your First AI Agent" using this JSON schema:

[Paste the schema from above]

Requirements:
- Content type: tutorial
- Difficulty: beginner
- Include:
  * Introduction paragraph
  * Step-by-step instructions with code examples (Python)
  * A flowchart showing the agent architecture
  * Image gallery with 3 relevant images
  * Key takeaways as bullet points
- Length: ~800 words
- Tags: ["ai-agents", "tutorial", "python", "beginners"]

Need Full Documentation?​

See docs/guides/CONTENT_JSON_SCHEMA.md for complete schema reference and content-template.json for a working example with all features.