A well-formatted SOP is finished work; an unformatted wall of text is half a job. The MaintIQ SOP editor is built on Markdown with a few maintenance-specific extras.
The toolbar
Across the top of the editor:
- B / I / S — bold, italic, strikethrough
- H1 / H2 / H3 — headings (H1 is the SOP title; use H2 for steps and H3 for sub-steps)
- • / 1. — bulleted and numbered lists
- ☐ — checklist (renders as a tickable box in the field view)
- 🔗 — link
- 🖼️ — image upload
- ▤ — table
- 💡 — callout (info / warning / danger)
- Code — inline
codeand fenced blocks
Best practices for in-field readability
- Use H2 for each major step and H3 for sub-steps. The on-page table of contents auto-generates from these.
- Keep paragraphs short — three lines max on a phone screen.
- Put every threshold or set point in bold.
- Use callout warnings for safety steps.
- Use checklists for any step that is easy to skip.
Tables
Tables are great for set points, tools, and parts lists. Use the toolbar button or type Markdown directly:
| Set point | Value | Tolerance |
|---|---|---|
| Hot water | 140 °F | ±5 °F |
| Walk-in cooler | 38 °F | ±3 °F |
Images
Drag any image into the editor. MaintIQ uploads it to your facility's storage and inserts the markdown. Images get a max width of 720 px in the field view to avoid horizontal scrolling.
Callouts
Type > [!warning] on a new line to start a warning callout. Supported types:
> [!info]> [!warning]> [!danger]> [!tip]
Keyboard shortcuts
| Shortcut | Action |
|---|---|
| ⌘B / Ctrl+B | Bold |
| ⌘I / Ctrl+I | Italic |
| ⌘K / Ctrl+K | Link |
| ⌘⇧7 | Numbered list |
| ⌘⇧8 | Bulleted list |
| ⌘S / Ctrl+S | Save draft |
Autosave
The editor saves a draft every 5 seconds. You will see "Saved" next to the title when the latest keystroke is persisted. You can close the tab and pick up exactly where you left off.