Help & Documentation

Everything you need to know about using Mashq-ai’s AI quiz generator, practice test workflows, and spaced repetition flashcards—from uploading slides and PDFs to exporting MCQs with answer keys.

How It Works

Mashq-ai uses advanced artificial intelligence (Large Language Models) to generate educational content instantly. Here's how each tool works:

Topics Generator

What it does: Generates a list of relevant topics within your subject area.

How to use:

  1. Enter your subject (e.g., "Machine Learning")
  2. Select difficulty level (Beginner/Intermediate/Advanced)
  3. Choose number of topics (1-50)
  4. Click Generate

Output: List of topics with brief descriptions

Book Generator

What it does: Creates comprehensive book outlines with detailed chapter content.

How to use:

  1. Enter book title or subject
  2. Add description (optional but recommended)
  3. Select number of chapters (3-12)
  4. Click Generate

Output: Full book outline with detailed chapter content and markdown formatting

MCQ Generator

What it does: Creates multiple-choice questions with answers.

How to use:

  1. Enter topic or upload file/link/image
  2. Select number of questions (1-50)
  3. Choose difficulty level
  4. Click Generate
  5. Take quiz or export as PDF

Output: Interactive quiz with instant feedback and scoring

Flashcard Generator

What it does: Creates digital flashcards for active recall practice.

How to use:

  1. Enter topic or upload content
  2. Select number of cards (1-50)
  3. Click Generate
  4. Flip cards to study, mark as learned
  5. Export as PDF when done

Output: Interactive flashcards with flip animation

Additional Tools

Story, Email, Slides, Quotes, Social Posts:

  • Story: Generate creative or educational stories
  • Email: Create professional business emails
  • Slides: Generate presentation slide outlines
  • Quotes: Create inspirational or topical quotes
  • Social Posts: Generate engaging social media content

Each tool requires a topic/prompt and delivers instant results.

Behind the Scenes:

  1. You enter your prompt/topic
  2. Our system sends a structured query to the AI model (Groq API with Llama 3.3)
  3. The AI generates content based on its training data
  4. We process and format the output for easy reading
  5. You receive the content instantly in your browser
  6. You can review, edit, and export as needed

Data Usage & Privacy

✓ Your Privacy is Protected

We take data privacy seriously. Here's exactly what we do and don't do with your data.

What We Collect:

  • Your Prompts/Topics: Temporarily processed to generate content, not stored permanently
  • Basic Analytics: Page views, tool usage counts (anonymous)
  • IP Address: For security and rate limiting only
  • Uploaded Files: Processed in memory, immediately deleted after content generation

What We DON'T Collect:

  • Personal Information: No names, emails, or contact details (unless you contact us)
  • Account Data: No login required, no passwords stored
  • Generated Content: Your results aren't saved on our servers
  • Browsing History: We don't track your other web activity

How Your Data is Used:

  1. AI Processing: Your prompt is sent to Groq API (third-party AI service) to generate content
  2. Service Improvement: Anonymous usage stats help us understand which tools are most popular
  3. Security: IP addresses help prevent abuse and spam
  4. Legal Compliance: We may retain minimal data as required by law

Data Retention:

  • Generated Content: Deleted when you close your browser tab
  • Uploaded Files: Deleted immediately after processing (within seconds)
  • Analytics: Aggregated data retained for up to 12 months
  • Logs: Server logs retained for 30 days for security purposes

Your Rights:

Under GDPR and similar privacy laws, you have the right to:

  • Access any data we hold about you
  • Request deletion of your data
  • Opt out of analytics
  • Export your data (though we store very little)

Contact us at contact@mashq-ai.com for data requests.

Prompt Tips for Better Results

The quality of AI-generated content depends heavily on your prompts. Here are proven strategies for getting the best results:

✓ DO: Be Specific

❌ Too Vague:

"Science"

✓ Better:

"Photosynthesis in plant biology for high school students"

✓ DO: Include Context

❌ No Context:

"American History"

✓ Better:

"American History: The Civil War era (1861-1865) including causes, major battles, and outcomes"

✓ DO: Specify Difficulty Level

Beginner: "Introduction to Python programming for absolute beginners with no coding experience"

Intermediate: "Object-oriented programming in Python for developers with 1-2 years experience"

Advanced: "Advanced Python: metaclasses, decorators, and async programming for senior developers"

✓ DO: Use Keywords and Phrases

  • For Topics: "Beginner-friendly topics in...", "Advanced concepts related to..."
  • For MCQs: "Quiz on... covering concepts A, B, and C"
  • For Books: "Comprehensive guide to... including practical examples"
  • For Flashcards: "Key terms and definitions for... exam preparation"

❌ DON'T: Common Mistakes to Avoid

  • Too broad: "Everything about math" → Narrow to specific topics
  • Multiple unrelated topics: "Physics and cooking and poetry" → Focus on one subject
  • Ambiguous terms: "Cell biology" → Specify: "Plant cell structure for biology 101"
  • Non-educational requests: AI may not generate good results for opinion-based or creative fiction

🎯 Pro Tips:

  1. Start broad, then narrow: Generate topics first to see what interests you, then create detailed content on specific topics
  2. Use jargon appropriately: Include technical terms for advanced content, avoid them for beginner material
  3. Specify format: "Create a timeline of...", "Compare and contrast...", "Explain step-by-step..."
  4. Request examples: "Include practical examples of..." or "Provide real-world applications"
  5. Iterate: If results aren't perfect, regenerate with a refined prompt

Limitations & Important Notes

⚠️ AI is a Tool, Not a Replacement for Learning

While Mashq-ai is powerful, it has limitations. Understanding these helps you use the platform effectively and responsibly.

1. Accuracy Limitations

  • Not 100% Accurate: AI can make factual errors, especially with very recent events (post-2023)
  • May Hallucinate: Sometimes generates plausible-sounding but incorrect information
  • Biased Training Data: Reflects biases present in its training data
  • → Always verify critical information with authoritative sources

2. Knowledge Cutoff

  • Training Data: AI model trained on data up to early 2023
  • No Real-Time Info: Can't access current news, stock prices, or recent events
  • Outdated Content: May not reflect latest research or discoveries
  • → Supplement with current textbooks and resources

3. Subject Matter Depth

  • Generalist Model: Better at broad topics than extremely specialized niches
  • Surface Level: May lack depth for graduate-level or highly technical subjects
  • Popular Topics: Performs best on well-documented subjects with abundant training data
  • → Use as a starting point; consult experts for advanced topics

4. Content Generation Limits

  • Length Constraints: Maximum ~4000 words per generation (varies by tool)
  • Formatting: Complex tables, equations, or diagrams may not format perfectly
  • Creative Content: Better at factual/educational content than creative fiction
  • Rate Limits: Free tier has limits on requests per minute to prevent abuse
  • → Break large projects into smaller chunks

5. Language & Cultural Context

  • English-Centric: Best performance in English; other languages may have reduced quality
  • Western Bias: Training data skewed toward Western educational systems
  • Cultural Nuances: May miss culture-specific context or references
  • → Review content for cultural appropriateness

6. Ethical & Academic Considerations

  • Plagiarism Risk: Don't submit AI-generated work as your own without proper attribution
  • Academic Integrity: Many institutions have policies on AI use—check your school's guidelines
  • Learning Shortcut: Using AI to bypass learning defeats educational purpose
  • Citation Needed: Disclose when you've used AI assistance
  • → Use AI to enhance learning, not replace it

What Mashq-ai Should NOT Be Used For:

  • Medical, legal, or financial advice
  • Emergency decision-making
  • Submitting assignments without review/attribution
  • Professional certifications or licensing exams (as sole resource)
  • Replacing qualified human instructors or experts

✓ Best Practices:

  1. Use Mashq-ai as a study aid, not your only resource
  2. Verify facts with textbooks, instructors, or authoritative sources
  3. Edit and personalize generated content
  4. Cite AI assistance when required
  5. Combine with traditional learning methods for best results
  6. Report errors to help us improve

Examples Gallery

See real examples of what you can create with Mashq-ai tools. These demonstrate the quality and variety of content our platform generates.

Topics Generator Example

Prompt: "Machine Learning for Beginners"

Difficulty: Beginner | Count: 5

1. Introduction to Machine Learning

Understanding what machine learning is, its applications, and how it differs from traditional programming

2. Supervised vs Unsupervised Learning

Key differences between supervised learning (with labeled data) and unsupervised learning (discovering patterns)

3. Common ML Algorithms

Overview of popular algorithms like linear regression, decision trees, and k-means clustering

MCQ Generator Example

Prompt: "World War II History"

Difficulty: Intermediate | Count: 3

Q1: When did World War II officially end?

A) May 8, 1945

B) August 15, 1945

C) September 2, 1945 ✓ (Correct)

D) December 7, 1945

Explanation: WWII officially ended on September 2, 1945, with Japan's formal surrender.

Flashcard Generator Example

Prompt: "Biology Cell Structure"

Count: 3

FRONT:

What is the mitochondria?


BACK:

The "powerhouse of the cell" - organelles that produce ATP through cellular respiration

FRONT:

Function of the nucleus?


BACK:

Contains DNA and controls cell activities; often called the "control center"

FRONT:

What is the cell membrane?


BACK:

Semi-permeable barrier that controls what enters and exits the cell

Book Generator Example

Title: "Introduction to Python Programming"

Chapters: 5

Chapter 1: Getting Started with Python

Introduction to Python, installation, and your first program...

Chapter 2: Variables and Data Types

Understanding strings, integers, floats, and booleans...

Chapter 3: Control Flow

If statements, loops, and conditional logic...

...and 2 more chapters with detailed content

Try It Yourself!

These examples show what's possible with Mashq-ai. Your results will vary based on your prompts and settings.

Start Creating Now →