chore: release v0.2.4 - #68
Merged
Merged
Conversation
## 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>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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:
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
#idvalues 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: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.