Point Types

In Decomposer, every point has a type. You can see a points type by right clicking and using the Type sub-menu, or by hitting Cmd+D to show the type indicators, which can be hovered and clicked on.

A points type controls how it serializes into markdown. This is best shown by example:

Supported point types

Point type	Can have children	Markdown form
Heading 1 … Heading 6	yes	# … ###### headings
Sentence	no	plain sentence text
Paragraph	yes (sentence only)	rendered from child sentences
Blockquote	yes	> blockquote
Bullet	yes	- item
Numbered	yes	1. item
To-do	yes	- [ ] item / - [x] item
Horizontal rule	no	---
Table	no	GFM table
Code	no	fenced code block
Toggle	yes	text + indented children

Editing a point’s type

You can change a points type by clicking the type indicator.

Or by right clicking and using the Type sub-menu.

Or by using the floating menu in reading mode.

Or by using the type shortcuts (covered in Type Shortcuts).

Restrictions

A points type can limit its behavior in certain ways.

• Sentence, Horizontal Rule, Code, and Table cannot have children.
• Paragraph can only contain Sentence children.
• Heading nesting is strictly downward:
  • Heading 1 can contain Heading 2 … Heading 6 (but not Heading 1)
  • Heading 2 can contain Heading 3 … Heading 6 (but not Heading 1/Heading 2)
  • …
  • Heading 6 cannot contain any heading
• Other container types (Blockquote, Bullet, Numbered, To-do, Toggle) can contain mixed point types, subject to normalization rules.

You don’t need to remember these. These are invalid states the points editor won’t let you get into.

Workflow

When you are writing down all of your thoughts, you don’t need to consider a point’s type. Working with bullet points helps you get your thoughts on the page without worrying about formatting.

When it’s time to start considering presentation, that is when I start to worry about a points type.