Editorial planning guides

Turn a Rain Barrel Topic Into an Editable Article Plan

·

Start with the questions your readers need answered before building a draft. Use the outline to decide which questions deserve a section and which belong under a larger topic.

Article Outline Generator

Build the rain barrel tutorial outline

Choose Load worked example and Generate outline. The topic is Rain barrel setup, the audience is first-time gardeners and the tone is Step-by-step tutorial. Detailed depth generates six H2 headings and six H3 headings below the title.

The first section is Prepare for Rain barrel setup. The audience is visible in Prerequisites for first-time gardeners. Replace Heading 2 with Check the downspout connection and save article-outline.md. Check that your new heading begins with three hash signs beneath the first H2.

Build the rain barrel tutorial outline
Outline positionLevelText
Article titleH1Rain barrel setup
Heading 1H2Prepare for Rain barrel setup
Edited heading 2H3Check the downspout connection
Heading 4H3Prerequisites for first-time gardeners

Open Article Outline Generator and load the rain barrel tutorialW3C WAI, heading levels and document structure

Change the emphasis with a different tone

Choose Comparison and Brief and generate again. The article opens with Options for Rain barrel setup, then Criteria for judging the options. The six headings are all H2. The named audience still has a reader-needs section.

Generate outline replaces the current rows using the selected settings. Copy any edits you want to keep before regenerating. Use Comprehensive when you want two suggested H3 prompts under each H2.

Open Article Outline Generator and load the rain barrel tutorial

Finish the heading order before publication

Add, remove and move rows until the article follows your reader’s task. Keep each H3 below its related H2. HTML export encodes the levels as h1, h2 and h3 elements.

Check the destination editor’s heading roles after pasting. The starter outline describes several questions without determining the facts or deciding which sections your subject requires.

W3C WAI, heading levels and document structure

Common questions

Can I keep a shorter outline with only section headings?

Choose Brief and generate the outline. It starts with six sections that you can then shorten or extend.

Can I export punctuation in headings?

Yes. The working title remains visible in both outputs. Markdown and HTML escape characters that would otherwise change the document structure.

Sources and example

Put it into practice.

Related guides