| name | backlog-notation |
| description | Syntax reference for Backlog notation (Backlog記法), the native markup syntax for Nulab Backlog. Covers headings, lists, tables, text styling, links, code blocks, and other formatting elements. |
backlog-notation
Backlog notation (Backlog記法) syntax reference. This is not Markdown — do not mix the two syntaxes.
Quick Reference
| Feature | Syntax |
|---|
| Heading | * H1 / ** H2 / *** H3 / **** H4 |
| Bold | ''text'' |
| Italic | '''text''' |
| Strikethrough | %%text%% |
| Color | &color(red) { text } |
| Color + background | &color(#fff, #333) { text } |
| Bullet list | - item (nest with --) |
| Numbered list | + item (nest with ++) |
| Checklist | - [ ] todo / - [x] done (issue descriptions only) |
| Link | [[https://example.com]] |
| Labeled link | [[label>https://example.com]] |
| Issue link | PROJECT-123 (auto-linked) |
| Quote | > text or {quote}...{/quote} |
| Code block | {code}...{/code} |
| Code (lang) | {code:java}...{/code} |
| Image | #image(URL or filename) |
| Thumbnail | #thumbnail(URL or filename) (< 200KB) |
| Table of contents | #contents |
| Line break | &br; |
| Escape | \ before special characters |
Tables
Separate cells with |. End a row with h for a header row. Prefix a cell with ~ for a row header. Use > to merge a cell with the one to its left.
|Name|Value|Note|h
|~Header|data 1|data 2|
|Span two||>|
Markdown → Backlog Notation Conversion
| Markdown | Backlog Notation |
|---|
# H1 | * H1 |
**bold** | ''bold'' |
*italic* | '''italic''' |
~~strike~~ | %%strike%% |
1. item | + item |
``` | {code} / {/code} |
[text](url) | [[text>url]] |
 | #image(url) |
|---| separator | |h at end of row |
| N/A | &color(red) { text } |
Gotchas
- No inline code syntax — only block-level
{code}...{/code}
{quote} blocks cannot be nested- Checklists work only in issue descriptions, not in comments or wikis
- Supported code languages:
java, cs, js, python, ruby, perl, php, sql, html, xml, css, shell, etc.
