backlog-notation

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.