Lists

SevenMark supports two list syntaxes:

• Brace lists: {{{#list ...}}}
• Markdown lists: - , + , * , 1. , 1) , a. , a) , A. , A) , i. , i) , I. , I)

Basic Lists

Brace-list items are structural [[...]] segments:

{{{#list #1
[[First item]]
[[Second item with [[https://example.com | a link]]]]
}}}

The list kind is selected by flag parameters: #1, #a, #A, #i, or #I. If no kind flag is present, renderers treat the list as an unordered list. The item body is trimmed at the structural segment boundary and then parsed as nested SevenMark content.

Numeric List (1, 2, 3...)

{{{#list #1
[[Item 1]]
[[Item 2]]
[[Item 3]]
}}}

Lowercase Alphabetic List (a, b, c...)

{{{#list #a
[[First item]]
[[Second item]]
[[Third item]]
}}}

Uppercase Alphabetic List (A, B, C...)

{{{#list #A
[[First item]]
[[Second item]]
[[Third item]]
}}}

Lowercase Roman Numerals (i, ii, iii...)

{{{#list #i
[[First item]]
[[Second item]]
[[Third item]]
}}}

Uppercase Roman Numerals (I, II, III...)

{{{#list #I
[[First item]]
[[Second item]]
[[Third item]]
}}}

Nested Lists

Lists can be nested within other lists:

{{{#list #1 #style="margin-left:20px"
[[**Chapter 1**: Introduction]]
[[Subsection: {{{#list #a [[Point A with *emphasis*]] [[Point B with [now]]] }}} ]]
[[**Chapter 2**: Advanced Topics]]
}}}

Styled Lists

List-wide Styling

{{{#list #1 #style="color:blue; margin-left:20px"
[[Blue colored item 1]]
[[Blue colored item 2]]
}}}

Complex List Example

{{{#list #1 #style="margin-left:20px"
[[**Chapter 1**: Introduction]]
[[Subsection: {{{#list #a [[Point A with *emphasis*]] [[Point B with [now]]] }}} ]]
[[**Chapter 2**: Advanced Topics]]
[[Complex item: {{{#fold [[Click here]] [[Hidden: ``` #lang="rust"
fn main() { println!("Deep!"); }
```
]] }}} ]]
[[Final chapter with ^^superscript^^ text]]
}}}

Conditional List Items

Lists support conditional rendering at item level using {{{#if}}} syntax.

Basic Conditional Items

Include or exclude list items based on a condition:

{{{#define #showAdvanced="true"}}}

{{{#list #1
[[Basic feature]]
[[Standard feature]]
{{{#if [var(showAdvanced)] == "true" :: [[Advanced feature]] }}}
[[Final feature]]
}}}

The conditional item [[Advanced feature]] is included only when showAdvanced is "true".

Inside a brace list, a conditional item block must contain item segments:

{{{#if [var(show)] == "true" :: [[One item]] [[Another item]] }}}

Multiple Conditional Items

You can include multiple items in a single conditional:

{{{#define #isPremium="true"}}}

{{{#list #1
[[Free feature 1]]
[[Free feature 2]]
{{{#if [var(isPremium)] == "true" ::
[[Premium feature A]]
[[Premium feature B]]
[[Premium feature C]]
}}}
[[Common feature]]
}}}

Conditional with Complex Expressions

{{{#define #userLevel="3"}}}

{{{#list #1
[[Level 1 content]]
{{{#if int([var(userLevel)]) >= 2 :: [[Level 2 content]] }}}
{{{#if int([var(userLevel)]) >= 3 :: [[Level 3 content]] }}}
{{{#if int([var(userLevel)]) >= 4 :: [[Level 4 content]] }}}
}}}

Practical Example: Feature List

{{{#define #plan="pro"}}}

{{{#list #1
[[✓ Basic support]]
[[✓ 10GB storage]]
{{{#if [var(plan)] == "pro" || [var(plan)] == "enterprise" ::
[[✓ Priority support]]
[[✓ 100GB storage]]
}}}
{{{#if [var(plan)] == "enterprise" ::
[[✓ Dedicated account manager]]
[[✓ Unlimited storage]]
[[✓ Custom integrations]]
}}}
}}}

Lists with Rich Content

List items can contain any SevenMark elements:

{{{#list #1
[[Text styles: **bold**, *italic*, __underline__]]
[[Code: ```
println!("Hello!");
```
]]
[[Tables: {{{#table [[[[Item]] [[Value]]]] [[[[A]] [[1]]]] [[[[B]] [[2]]]] }}}]]
[[Media: [[file:example.png | Example image]]]]
}}}

Markdown List Parsing Policy

When markdown list markers are used, SevenMark follows these parser rules.

1. Nesting is based on the content column

Nesting is determined by the marker's content column (marker + required space), not only by raw leading spaces.

2. Lazy continuation is allowed, but list markers are a hard boundary

For a list item, a following line is treated as lazy continuation when:

• it is non-empty, and
• it is indented to at least the current item's content column.

However, if that continuation candidate starts with a valid list marker, it is not consumed as continuation. It starts a new list line instead.

3. Block starters can stay inside list item content

Lines like blockquotes (>), horizontal lines (---), and other block constructs can be part of the current list item when they satisfy continuation indentation. They are then re-parsed as nested blocks inside that item.

4. Root-level marker type boundary

At the root level, a marker-type change (for example - to *, or 1. to 1)) ends the current markdown list block. The next marker starts a new list block.

5. Ordered marker families

• i / I markers are treated as roman-style list kinds.
• Other alphabetic markers are treated as alphabetic list kinds.