Writing Articles

Writing Articles

You write articles in Zingasolve's Markdown editor. It pairs a plain-text
editing pane with a formatting toolbar and a live preview, so you can work in raw
Markdown or click your way through common formatting.

The editor

Open any article to edit it. Along the top you have:

• Locale tabs — switch between the languages enabled for the Space. A dot
  shows each locale's status (draft, published, or outdated), and the source
  locale is marked.
• A title field and the body editor.
• Save draft and Publish buttons, plus a Preview / Edit toggle.

Formatting toolbar

The toolbar inserts Markdown for you at the cursor:

• Bold, italic, and inline code
• Headings, block quotes, and code blocks
• Bulleted and numbered lists
• Links
• Images — pick from your media library or insert by URL
• Video, table, annexure reference, and reusable content inserts

Uploading media

You can drag and drop or paste images (and videos) directly into the body —
they upload to your media hosting and the correct Markdown or directive is
inserted automatically. Images become standard Markdown image tags; videos
become a @[video] directive (see below).

Preview

Toggle Preview to see the rendered page, including tables, embedded video,
annexure cross-references, and reusable content expanded inline — matching how
the published site will look.

Standard Markdown

Everything you'd expect from Markdown works, and it renders the same on the live
site:

• Headings (#, ##, ###), bold, italic, and inline code
• Bulleted and numbered lists, block quotes
• Links and images
• Fenced code blocks with a language hint
• Tables

For example, a table:

| Setting | Default | Notes |
| --- | --- | --- |
| Timeout | 30s | Maximum wait |
| Retries | 3 | Per request |

Directives

On top of standard Markdown, Zingasolve adds three directives for content
Markdown can't express on its own. Each is written as @[name](argument).

Embedding video

Put a @[video] directive on its own line. Zingasolve renders a responsive
player — an embedded player for YouTube, Vimeo, or a hosted video URL, or a
native video player for a direct file link (.mp4, .webm, .ogg, .mov).

<div style="position:relative;padding-top:56.25%;margin:8px 0"><iframe src="https://www.youtube.com/embed/dQw4w9WgXcQ" loading="lazy" style="position:absolute;inset:0;height:100%;width:100%;border:0;border-radius:6px" allow="autoplay;encrypted-media;picture-in-picture;fullscreen" allowfullscreen></iframe></div>

The toolbar's video button lets you upload a video file or paste a YouTube/Vimeo
link and inserts this directive for you.

Referencing an annexure

Use @[annexure] to cross-reference a document annexed to the manual. The
argument is the annexure's stable reference key. On the page it renders as a live
"Annexure N: Title" reference (linked to the file where available), and the
number stays correct even if you reorder annexures.

See Annexure — for the full circuit layout.

Add annexures to the manual first; the toolbar's annexure button lists them so
you can insert the right key. See Annexures & Reusable Content for details.

Including reusable content

Use @[include] to embed a reusable section that is authored once and reused in
many places. The argument is the source section's ID. At render time it is
replaced with that section's current published content, so editing the
source updates every page that includes it.

<!-- zs:include unavailable -->

The toolbar's reusable-content button lists the sections you've marked reusable
and inserts the directive for you. See Annexures & Reusable Content for the
full workflow.

Saving and publishing

Save draft stores your working copy for the current locale without changing
the live site. Publish freezes the current content as a new version and makes
it live. The version history panel lists every published version with its
number, title, and date. Publishing is covered further in Publishing & the
Docs Site.