0.5.2

You can download this release through any of the following package managers:

Package manager	Command
Cargo	cargo install mdzk
AUR (with Paru)	paru -S mdzk
Homebrew	brew install mdzk
Nix	nix shell nixpkgs#mdzk

Changelog

Fixes

• #70: Fixed issue where parentheses were not allowed in internal links.

  577e84c: allow non-square brackets in internal links

0.5.1

Changelog

Added

• #66: All CSS variables can now be changed directly in the configuration file. For example, say you want to set the variable --sidebar-bg to red. To do this, you can simply add

  [style]
  sidebar-bg = "red"

  This should work for all CSS variables.

• #66: Add any custom CSS through the configuration file. You can either write CSS as a string directly in mdzk.toml, like this:

  [style]
  additional-css = """
  <CSS here>
  """

  or you can load a separate CSS file, like this:

  [style]
  additional-css = "path/to/file.css"

  Paths are relative to the mdzk.toml file.

Changed

• #66: mdzk now has a custom renderer and a new look. Everything should look more clean and polished, and you can expect some performance improvements as well.
• #66: KaTeX is no longer loaded through a CDN, but written to the generated site. This means your mdzk will work offline as well.
• #66: The default renderer is no longer mdbook, but mdzk. You can change back to rendering with mdBook by adding --renderer mdbook after the build command.

Fixed

• #67: You could previously not use ? characters in a title, because they were not escaped properly in URLs. This is now fixed with the introduction of our custom renderer.
• #66: Note titles are now added to the search index as well.

Removed

• #66: You can no longer theme mdzk like in mdBook (by adding a directory called theme). See above for how you can customize your mdzk.

0.5.0

Changelog

New features

• #55: You can now turn off each preprocessor feature of mdzk separately. This is done with the following configuration values:

  [build]
  # ...
  front-matter = false
  math = false
  readme = false
  math = false

  More about these features and what they do, can be found in the documentation.

• #39: Wikilinks now support blockreferences. Mark a paragraph with an ID by appending it with a space, a ^ and then a six-character ID. Then you can link to this paragraph, by using the syntax [[Note^#id]], where Note is the name of the note and id is the ID of the paragraph. You can read more about blockreferences in the documentation.

Enhancements

• #54: Our separate preprocessor crates are now moved to within the mdzk crate. This allows us to avoid iterating over the vault multiple times, which drastically increases the efficiency.
• #45: New custom made user interface, for a friendlier look. Expect more informative messages from this update and on.
• Enabled pulldown-cmark's SIMD accelerated scanners.

Bug fixes

• #63: Fixed buggy KaTeX rendering and simplified the rendering code a lot. Special thanks to @TheFr1nge for fixing this.
• #41: mdzk will not panic on invalid TOML anymore, but rather print an error message coupled with the configuration content and a description of what part of it is invalid.
• #40: mdzk now checks whether you updated your mdzk.toml correctly or not. If a [book] section is found in your mdzk.toml file, a warning will appear that prompts the user to change it to [mdzk].
• When loading the mdzk from another directory than the root directory, parsing the summary would throw an error, as the path to it was not absolute. This is now fixed, which means you can build an mdzk located anywhere, from anywhere.

0.4.3

Changelog

New features

• New generate-summary key at the [mdzk] section in mdzk.toml that controls whether mdzk will generate your summary file automatically or not. The default value is true.

• New preprocessors field under the [build] section in mdzk.toml. This lets you define mdBook preprocessors to be run after the default preprocessors. Order is preserved.

• New draft option in the front matter. Setting this to true will skip rendering for that note.

  NOTE: Beware that the note will still show up in the index, as that is how mdBook handles draft chapters. We will probably change this behaviour as soon as we release our custom renderer. If you want to hide a note completely from your vault, use the ignore field in mdzk.toml.

Enhancements

• Removed several dangerous unwraps, to make the codebase more robust.
• The Nix build now supports Apple Silicon as well.
• Dependencies have been cleaned up, leading to a slightly smaller binary size.
• New version of mdbook-wiklinks (0.4.0), that replaces regexes in favor of a combination of pulldown-cmark's iteration and a custom Pest parser. This should decrease build times drastically.
• Math delimiters are now converted into spans/divs on build. This will hopefully make KaTeX support more robust, and ignore math rendering within code and links.

Bug fixes

• #38: User-defined preprocessors (through the mdBook-style preprocessor.<name> pattern in the config file) would sometimes interfere with mdzk's default preprocessors. This fix converts all of these preprocessor-statements into the preprocessors field mentioned above, which mdzk can handle the order of.

  NOTE: To simplify compatibility between mdzk and mdbook, we assume the preprocessor has a command on the form mdbook-<name>. Other preprocessors are simply not supported yet. Fields are ignored, so you can only turn preprocessors on or off.

• #24: mdzk.backlinks-header in the config had no defuault value, which made mdzk panic when it was not set. This is now fixed.

0.4.2

This is a quick update that should make compiling mdzk easier (and even possible) for Windows users.

We have also experienced some trouble with Windows Defender flagging pre-compiled mdzk binaries as a trojan. This is a false positive. A report is submitted to Microsoft, and we have removed all previously released Windows binaries. We suspect the warning is related to the amount of embedded JavaScript that is contained in mdzk. Hopefully, you will not get any warnings from this version and onwards. If you do, please leave a comment with a screenshot of the warning in this issue.

Changelog

New features

• When naming a file the same name as it's parent directory, this file will work as the content of that directory. Namely, the directory will itself function as a note.

Bug fixes

• Our dependency on mdbook-katex, and subsequently QuickJS, did not work well with most Windows computers. To circumvent this, KaTeX is now loaded from a CDN and handles the rendering client-side. This shouldn't lead to any significant increases in load time, but it is not ideal for offline usage. We are working on embedding KaTeX locally in the generated output, which hopefully will be included soon.

0.4.1

Changelog

Enhancements

• The mdzk renderer now converts .md into .html in links/images during rendering.

Bug fixes

• Fixed init command. It did not produce a correctly formatted config file, and a subsequent build failed.

0.4.0

With version 0.4.0, we finally supply pre-compiled x86 binaries for Linux. On other devices/architectures, you have to compile mdzk yourself - using cargo install mdzk. We hope to supply binaries for these platforms as well soon.

Changelog

Breaking changes

• The [book] table header in mdzk.toml is now changed to [mdzk]. You will need to change this in your own configuration, or else the values will be ignored.
• The disable-default-processors configuration option is now placed under the [build] table.

New features

• An ignore field is added under the [mdzk] table. This is a list of gitignore-style patterns that specify files or directories which mdzk should ignore when building.
• The header above the backlinks can now also be configured under the [mdzk] table, with the backlinks-header field. Both this and the previous preprocessor.backlinks.header field are supported, but you are recommended to use the former, in case we might remove the latter.
• You can now choose a renderer with the --renderer or -r flag when running build or serve. The choices are between mdbook, markdown or mdzk, the latter being our own work in progress custom renderer. This feature is mostly for debugging purposes.

Enhancements

• We now use our own configuration struct. This will allow us to more easily expand mdzk with more options and configuration.
• The mdzk renderer now copies over KaTeX locally in the output, to ensure speedy math rendering.
• The mdzk renderer now uses the Inter font.