Article creator AI outline macros explained

What are AI outline prompts?

When you load any longform AI template in the Article creator it uses a special outline prompt.

This prompt starts with the <ai_outline_prompts> tag.

Each tag refers to a part of the HTML outline tree and is what is used to create prompts sent to the AI model.

For example:

<ai_outline_prompts>

  <prompt_h2>
    <h2>%h2%</h2>
    [write a short introductory paragraph about %h2% in language %language%. 
    Use html <p></p> tags. Don't use html attributes. Start with a paragraph. 
    The topic of the article is %keyword%.]
  </prompt_h2>
  
  <prompt_h2_no_children>
    <h2>%h2%</h2>
    [write an answer about %h2% in language %language%. 
    Use html <p></p> tags. Don't use html attributes. Start with a paragraph.
    {Insert a html <ul><li> bullet list or a <ol><li> numbered list||||}. 
    The topic of the article is %keyword%.]
  </prompt_h2_no_children>
  
  <prompt_h3_no_children>
    <h3>%h3%</h3>
    [write an answer about %h2%, %h3% in language %language%. 
    Use html <p></p> tags. Don't use html attributes. Start with a paragraph.
    {Insert a html <ul><li> bullet list or a <ol><li> numbered list||||}. 
    The topic of the article is %keyword%.]
  </prompt_h3_no_children>
  
</ai_outline_prompts>

AI outlines are only written if the user macro contains a definition for %ai_outline%

The output of %ai_outline% should be something like this:

<h2> cat </h2>
<h3> food </h3>
<h2> dog <h2>

AI outline tags list

Given the example outline above, what appears inside the %h2%, %h3% macros inside the <ai_outline_prompts> tag?

<prompt_h2>

This is the prompt the AI will use when you have a h2/h3. This is called on the parent h2 only.

In the example above, you will have the macro,
%h2% = cat

<prompt_h2_no_children>

This is the prompt when you have just a h2 with no h3 etc children.

In the above outline, it will only pass the dog heading (as it doesn’t have any h3 under it)
%h2% = dog

<prompt_h3_no_children>

This is the prompt that is used when it gets to a h2 → h3. Called on the h3 child of a h2 parent.

This prompt section has the macros,
%h2% = cat
%h3% = food

You can use both %h2% %h3%, to write out to the AI that the content should be about ‘cat food’.