What AI Markdown Quick Guide

This guide will help you understand how to use AI markdown effectively, ensuring that your prompts are structured, clear, and impactful. AI markdown is a powerful tool for formatting text and creating well-organized, easy-to-read documents. By mastering its syntax and understanding how to create well-crafted prompts, you can maximize the performance of AI models.

This will help you understand how to prompt any LLM and feed more instructions into your AI Extra instructions in Coco.

Understanding AI Markdown

AI markdown is a lightweight markup language that helps you format text documents in a visually appealing manner while keeping things simple. Below are some essential elements and syntax you should be familiar with:

Headers

Headers allow you to structure your document hierarchically. Use # for main headers, ## for subheaders, and so on. For example:

• # Header 1 (Main header)

• ## Header 2 (Subheader)

• ### Header 3 (Sub-subheader)

Headers help break down content into sections, making it easier for both humans and AI to navigate.

Emphasis

You can add emphasis to your text using asterisks * or underscores _:

• Bold: **bold** or __bold__

• Italic: *italic* or _italic_

• Bold and Italic: ***bold and italic***

These formatting options help highlight important points or key phrases.

Lists

Lists are crucial for organizing information clearly. You can create:

• Unordered (bullet) lists: Use a hyphen -, asterisk *, or plus + followed by a space.

• - Item 1

• * Item 2

• + Item 3

• Ordered (numbered) lists: Start with a number followed by a period.

• 1. Item 1

• 2. Item 2

• 3. Item 3

Lists are great for summarizing ideas or structuring step-by-step instructions.

Code

When you need to include code snippets or inline code, use backticks ( `` `

) to format them:

*   **Inline code**: Use a single backtick for inline code, e.g.,

code ``.

• Code blocks: Use triple backticks to create code blocks (with optional language specification).

def hello_world():
        print("Hello, world!")

This is particularly useful for technical instructions or examples where precise formatting is needed.

Links

To create hyperlinks, use the following format:

• [Link Text](URL) for a clickable link.

For example: [Google](https://www.google.com) will appear as Google.

Writing Effective Prompts

When crafting prompts, clarity, detail, and purpose are key to achieving the best results from AI models. Here’s how to write effective prompts that harness the full potential of the AI:

Define Your Objective

Begin by clearly stating what you aim to achieve with the prompt. Whether it’s generating text, performing data analysis, or assisting in decision-making, clearly articulating your goal sets the direction for the AI to follow.

• Example: "Generate a creative product description."

• More Specific: "Generate a product description for an eco-friendly water bottle emphasizing sustainability, ease of use, and health benefits."

Be Specific

Vague instructions lead to ambiguous results. Provide as much detail as possible to ensure the AI understands your exact needs. This includes the context, desired tone, and specific requirements for the task.

• Example: "Write a blog post about the benefits of renewable energy."

• Improved: "Write a 500-word blog post targeting millennials that explains the environmental and financial benefits of switching to solar energy in an engaging, informal tone."

Use Delimiters

Use delimiters to clearly separate different sections or examples within your prompt. This helps the AI understand boundaries and structure. You can use triple quotes """ or other delimiters like === to create clear separations.

• Example:

"""
    Input: I need a product description for a smart speaker.
    Output: Write a description highlighting the speaker’s features and usability in a casual tone.
    """

Include Examples

Including examples of the style or type of response you want helps guide the AI. Be sure to specify the format, tone, and any other elements you want to replicate.

• Example:

"Here’s an example of the type of tone I’m looking for:

"""

Our EcoSip Water Bottle not only keeps your drink at the perfect temperature but also helps preserve our planet.

Made from sustainable materials, it's lightweight for easy portability.

Join the eco-friendly hydration revolution today!

"""

"Based on this, generate a new description for our product, a smart coffee mug."

Iterate and Refine

Effective prompt writing is often iterative. Start with a basic version, test it, analyze the results, and refine it based on the feedback. AI models might need adjustments in phrasing, detail level, or tone to match your expectations.

• Example: If the first prompt doesn’t result in the right output, modify the prompt to be clearer or more detailed.

Example Prompt

Let’s look at an example prompt written in AI markdown for generating a product description:

Task

Your task is to write an engaging product description for a new eco-friendly water bottle.

Guidelines:

• Highlight its innovative features.

• Emphasize environmental benefits.

• Create a compelling narrative around the product's user experience.

• Be creative! Below is an example style:

"""
Our EcoSip Water Bottle not only keeps your drink at the perfect temperature but also helps preserve our planet.
Made from sustainable materials, it's lightweight for easy portability.
Join the eco-friendly hydration revolution today!
"""

Generate a description based on these guidelines.

• * *

By following these tips and expanding on the basic AI markdown syntax, you can craft more precise, efficient, and effective prompts that will lead to better responses from AI models.

Updated on: 13/05/2025