Text formatting¶

Specivo renders Markdown everywhere you write longer text: issue descriptions, comments, and wiki pages. The same syntax works in all three. This page covers what's supported, plus two Specivo-specific extras — @username mentions and [[wiki links]].

Headings¶

# Heading 1
## Heading 2
### Heading 3

In the wiki, the page title is shown as the page heading already, so start your body at ## rather than repeating an # H1.

Emphasis¶

Lists¶

- First item
- Second item
  - Nested item

1. Step one
2. Step two

Task lists work too:

- [x] Done
- [ ] Not done yet

Links and images¶

[Link text](https://specivo.example.com)
![Alt text](https://specivo.example.com/image.png)

To attach and embed an image on an issue or wiki page, upload it as an attachment first, then link to it.

Blockquotes¶

> A quoted line.
> Continues the same quote.

Tables¶

| Field    | Type   | Required |
|----------|--------|----------|
| subject  | string | yes      |
| due date | date   | no       |

Pipe tables render as styled tables. Use them for field lists and option matrices.

Code blocks¶

Fence code with triple backticks and add a language hint for syntax highlighting:

```python
def hello(name: str) -> str:
    return f"Hello, {name}"
```

The language hint (python, bash, json, yaml, sql, and so on) controls the highlighting colors.

@username mentions¶

Type @ followed by a username to mention someone. The mention links to their profile and notifies them:

@alex can you review this before the release?

Mentions work in issue descriptions and comments. Use them to pull a specific person into a discussion.

Issue references¶

Write an issue's key — ACME-123 — in a description, a comment, or a wiki page and Specivo turns it into a link to that issue. You don't need any special syntax; the plain key is enough.

Specivo links a reference only when the issue actually exists (or existed before it was moved, in which case the old key still resolves). A token that looks like a key but doesn't match a real issue — a version string like API-2, a part number, a typo'd key — stays as plain text instead of becoming a dead link. That keeps references trustworthy: if it's a link, there's a real issue on the other end.

Wiki cross-links¶

Inside the wiki, link to another page in the same project with double brackets:

See [[Release Process]] for the steps.

You can link by title ([[Release Process]]) or by slug ([[release-process]]) — slugs are normalized, so [[My Page]], [[my-page]], and [[My_Page]] all resolve to the same page. See Linking & history for more.