Skip to content
Audience Docs

Content

Publishing and Markdown

How an approved article leaves Audience as a Markdown file, how to put it live in your own CMS, and what Reports start tracking once it is.

Publishing is manual in this release. Scout writes, checks and revises; a person approves; then the approved article leaves Audience as a file and you put it live yourself. Nothing Scout produces reaches the public without your hands on it.

Download Markdown

Once a version is approved, the draft review screen shows a Download Markdown button under the header, with the line "Approved and ready. Publishing is manual, put it live yourself." The button is always available for an approved article, whatever else is configured.

The file contains:

  • A short front matter block with the title, the slug and the meta description from the review screen's fields, so a CMS or a static site generator can read them without retyping.
  • The body as Markdown, with headings, lists, links and citations as they appear in the editor.

It is the approved version, exactly. If someone edits the draft after approval, that edit is a new version and the download is unchanged until a new version is approved. See versions and approval.

Putting it live

A short checklist that fits most CMSs:

  1. Create the page or post in your CMS and paste the Markdown body. Most editors accept Markdown directly or convert it on paste.
  2. Set the URL from the slug, the page title from the SEO title, and the description from the meta description.
  3. Check the links and the source attributions survived the paste.
  4. Publish, and confirm the page is reachable at the address you expect.

What Reports track afterwards

Once the page is live at a URL on your site, Reports begin measuring it. Give it about a week: search takes that long to notice a new page and start sending it impressions. From then on the page appears under Pages Scout published in Content performance, with its clicks, impressions, position, and a verdict on what to do next. Its article record shows Published under Publication and links to the Published page.

The Publishing settings page

Under the workspace menu, Publishing describes where finished articles would go. In this release it says that publishing straight to your CMS is off, and offers no destination to add. The Markdown download is the way out, and it does not depend on that page. Details are on publishing destinations.

Who can do this

Anyone who can approve a draft can download it: owners, admins and editors. See who does what.