github iamgio/quarkdown v1.9.0

10 hours ago

Main features and changes

VS Code extension & language server

The official Quarkdown extension for VS Code has finally arrived!

Based on the brand-new language server, the extension provides syntax highlighting, user-first completions, in-editor live preview, documentation browsing, diagnostics, and much more.

Live preview demo

Install the extension from the marketplace to get started.
This version (1.9.0) or above needs to be installed before the extension is enabled.

 

Live preview optimization

The architecture behind live preview has been redesigned and the experience should now be smoother and more reliable, as you can notice in the previous demo.

For more detailed information about the architecture, check out Inside Quarkdown - How does live preview work?.

 

Added sticky bottom anchor to preview

If the page is scrolled to the very end while in preview, hot reload will let the new scroll position stick to the end of the new document as well.

 

Preview browser selection

The new -b or --browser option for quarkdown c gives control over what browser should be opened when -p or --preview is used.

Accepted values:

  • default (default)
  • none
  • chrome
  • chromium
  • firefox
  • edge (Windows only)

The same option also applies for quarkdown start, with none as a default.
The --open flag was removed (now -b default).

Browser paths are looked up at specific fixed locations by the bootstrap script
and set in BROWSER_<name> environment variables. Overriding them will set the desired path.

 

PDF sandbox is now disabled by default on Linux

Until now, --pdf-no-sandbox was required on most Linux distributions, and not specifying it would cause the PDF export to fail.
Sandbox is now disabled by default on Linux (via the QD_NO_SANDBOX environment variable).

 

Improved stdlib documentation

The quality of stdlib documentation, available at quarkdown.com/docs and within the VS Code extension, has been vastly improved with more details and examples.

 

Fixed 'Input line is too long' error on Windows

Fixed an error that would prevent Quarkdown from launching on Windows if it's loaded from long paths, due to a Windows-specific length constraint.

 

Breaking changes

  • (Only for third-party tools) The endpoint for live preview is now localhost:<port>/live instead of the former localhost:<port>, which now serves static resources only.

What's Changed

  • feat(build): add Dockerfile by @iamgio in #177
  • feat(cli): allow browser launcher selection by @iamgio in #182
  • feat: let preview stick to the end of the document by @iamgio in #183
  • fix(build): fix 'Input line is too long' startup error on Windows by @iamgio in #178
  • fix: escape dot (.) in range parsing by @iamgio in #184
  • feat: language server by @iamgio and @FrancescoRocca in #180
  • perf!: optimize live preview by @iamgio in #188
  • fix(pdf): fix stale page margins in slides PDF by @iamgio in #190
  • fix(interaction): fix "NPM executable cannot be found at 'npm'" when .npmrc is present by @iamgio in #191

New Contributors

Full Changelog: v1.8.0...v1.9.0

Sponsors

Falconer

Don't miss a new quarkdown release

NewReleases is sending notifications on new releases.