Skip to content

chore: release v0.2.4 - #68

Merged
squidfunk merged 1 commit into
masterfrom
release/v0.2.4
Jul 30, 2026
Merged

chore: release v0.2.4#68
squidfunk merged 1 commit into
masterfrom
release/v0.2.4

Conversation

@squidfunk

Copy link
Copy Markdown
Member

Summary

This version of Zensical Studio introduces a new Markdown formatter, smarter links and anchors, and a code action to extract reference definitions.

Markdown formatting

Zensical Studio can now format Python Markdown and supported extensions directly in your editor. Formatting normalizes common authoring noise while preserving document structure:

  • Headings, lists, definition lists, block quotes, tables, code fences, references, footnotes, attribute lists, admonitions, details, and content tabs
  • Unordered and ordered list markers, task lists, indentation, and expanded list layout
  • Link and footnote definitions grouped at the end of the document
  • Trailing whitespace, repeated blank lines, and line-ending style
  • Safe inline normalization for supported links, images, titles, emphasis, and inline code

The formatter is structure-aware: nested content such as code blocks, tabs, admonitions, and block quotes retains its correct ownership and indentation. It reaches a stable result in one format action, so formatting again produces no further changes.

For safety, template syntax remains untouched, prose is not reflowed, and complex Markdown-enabled HTML tables are preserved as authored.

Smarter links and anchors

All #id values in this example are workspace symbols: Zensical Studio validates links to them, completes them, supports navigation and rename, and updates incoming links after saving an edit:

# Heading { #custom-id }

Paragraph content.
{ #paragraph-id }

- List item
  { #item-id }

Term { #term-id }
: Definition text

| Feature |
| --- |
| Anchorable cell { #cell-id } |

```python { #code-id }
print("Anchored code block")
```

<div id="html-id" markdown>
Markdown-enabled HTML content.
</div>

If you change the part after # in any of these anchors, Zensical Studio will update all links to it across the entire workspace.

Extract reference definitions

A new code action extracts inline links and images into reference definitions. Zensical Studio prefers shortcut references when possible, uses explicit labels when needed, and appends the new definition to the document’s trailing reference-definition group.

## Summary

This version of Zensical Studio introduces a new Markdown formatter, smarter links and anchors, and a code action to extract reference definitions.

### Markdown formatting

Zensical Studio can now format Python Markdown and supported extensions directly in your editor. Formatting normalizes common authoring noise while preserving document structure:

- Headings, lists, definition lists, block quotes, tables, code fences, references, footnotes, attribute lists, admonitions, details, and content tabs
- Unordered and ordered list markers, task lists, indentation, and expanded list layout
- Link and footnote definitions grouped at the end of the document
- Trailing whitespace, repeated blank lines, and line-ending style
- Safe inline normalization for supported links, images, titles, emphasis, and inline code

The formatter is **structure-aware**: nested content such as code blocks, tabs, admonitions, and block quotes retains its correct ownership and indentation. It reaches a stable result in one format action, so formatting again produces no further changes.

For safety, template syntax remains untouched, prose is not reflowed, and complex Markdown-enabled HTML tables are preserved as authored.

### Smarter links and anchors

All `#id` values in this example are workspace symbols: Zensical Studio validates links to them, completes them, supports navigation and rename, and updates incoming links after saving an edit:

```markdown
# Heading { #custom-id }

Paragraph content.
{ #paragraph-id }

- List item
  { #item-id }

Term { #term-id }
: Definition text

| Feature |
| --- |
| Anchorable cell { #cell-id } |

```python { #code-id }
print("Anchored code block")
```

<div id="html-id" markdown>
Markdown-enabled HTML content.
</div>
```

If you change the part after `#` in any of these anchors, Zensical Studio will update all links to it across the entire workspace.

### Extract reference definitions

A new code action extracts inline links and images into reference definitions. Zensical Studio prefers shortcut references when possible, uses explicit labels when needed, and appends the new definition to the document’s trailing reference-definition group.

Signed-off-by: squidfunk <martin.donath@squidfunk.com>
@squidfunk
squidfunk merged commit cc5119e into master Jul 30, 2026
3 checks passed
@squidfunk
squidfunk deleted the release/v0.2.4 branch July 30, 2026 15:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant