Skip to content

Lists ​

Write a list with brace syntax or Markdown line markers:

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

Basic Lists ​

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

sevenmark
{{{#list #type="numeric"
[[First item]]
[[Second item with [[https://example.com | a link]]]]
}}}

The list kind is selected with #type="numeric" | "alpha" | "roman", plus #upper for the uppercase variant (A, B, C / I, II, III). With no #type, the list is unordered. Values are double-quoted like every SevenMark parameter. The item body is trimmed at the structural segment boundary and then parsed as nested SevenMark content.

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

sevenmark
{{{#list #type="numeric"
[[Item 1]]
[[Item 2]]
[[Item 3]]
}}}

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

sevenmark
{{{#list #type="alpha"
[[First item]]
[[Second item]]
[[Third item]]
}}}

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

sevenmark
{{{#list #type="alpha" #upper
[[First item]]
[[Second item]]
[[Third item]]
}}}

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

sevenmark
{{{#list #type="roman"
[[First item]]
[[Second item]]
[[Third item]]
}}}

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

sevenmark
{{{#list #type="roman" #upper
[[First item]]
[[Second item]]
[[Third item]]
}}}

Start Value ​

Ordered lists can begin from a value other than the first. In the brace form, use #start="n":

sevenmark
{{{#list #type="alpha" #start="3"
[[Starts at c]]
[[d]]
[[e]]
}}}

For Markdown lists, the first marker sets the start value: 5. starts at 5, c. at c, and C. at C. Later items increment the counter regardless of their authored number. Two items marked 5. and 99. therefore render as 5 and 6.

Nested Lists ​

Lists can be nested within other lists:

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

Styled Lists ​

List-wide Styling ​

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

Complex List Example ​

sevenmark
{{{#list #type="numeric" #style="margin-left:20px"
[[**Chapter 1**: Introduction]]
[[Subsection: {{{#list #type="alpha" [[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:

sevenmark
{{{#let showAdvanced = true}}}

{{{#list #type="numeric"
[[Basic feature]]
[[Standard feature]]
{{{#if showAdvanced :: [[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:

sevenmark
{{{#if show == "true" :: [[One item]] [[Another item]] }}}

Multiple Conditional Items ​

You can include multiple items in a single conditional:

sevenmark
{{{#let isPremium = true}}}

{{{#list #type="numeric"
[[Free feature 1]]
[[Free feature 2]]
{{{#if isPremium ::
[[Premium feature A]]
[[Premium feature B]]
[[Premium feature C]]
}}}
[[Common feature]]
}}}

Conditional with Complex Expressions ​

sevenmark
{{{#let userLevel = 3}}}

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

Practical Example: Feature List ​

sevenmark
{{{#let plan = "pro"}}}

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

Lists with Rich Content ​

List items can contain any SevenMark elements:

sevenmark
{{{#list #type="numeric"
[[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 ​

The parser applies these rules to Markdown list markers.

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.