v2.13.0 🌈

Changes

🚀 Features

• Feature (configuration): Add configuration option docxNamingConvention to choose how to name .docx files @leojonathanoh (#75)
• Enhancement: Write .md files in UTF-8 without BOM for Powershell <= 5 @leojonathanoh (#79)
• Enhancement: Log any pandoc errors during conversion @leojonathanoh (#77)
• Enhancement: Improve dry run performance @leojonathanoh (#78)

🐛 Bug Fixes

• Fix: Fix last modified date epoch in .docx names not being in UTC in Powershell Core @leojonathanoh (#76)

v2.12.0 🌈

Changes since v2.11.1

This releases adds a new configuration option newlineCharacter to choose whether to use LF or CRLF for newlines in markdown, defaulting to LF. Media names are now prefixed with the hierarchy of the page they belong, e.g. mysectiongroup-mysection-mypage-image1.png to give it more meaning, especially when using central /media folder which is the default behavior (i.e. $medialocation = 1 ). Page headers now contain a modified date in addition to a created date, with Created: and Modified: labels.

🚀 Features

• Feature (configuration): Add configuration option newlineCharacter to choose whether to use LF or CRLF for newlines @leojonathanoh #64
• Enhancement: Add last modified date, add 'Created' and 'Modified' labels and timezone to dates in page header @leojonathanoh (#67)
• Enhancement: Fallback on default configuration for missing options in configuration file config.ps1 @leojonathanoh #66
• Enhancement: Use hierarchy-qualified static unique name for media @leojonathanoh #61
• Enhancement (tests): Improve test of determination of page prefix @leojonathanoh (#70)

🐛 Bug Fixes

• Fix: Fix bug where conversion would terminate on an empty Section Group or Section @leojonathanoh (#69)
• Hotfix: Fix markdown documents being converted with wrong file names @leojonathanoh (#68)
• Fix: Fix inserted attachment names not being markdown-encoded in final markdown @leojonathanoh (#73)

📝 Documentation

• Docs (configuration): Fix configuration option newlineCharacter description @leojonathanoh (#71)
• Docs (readme): Update readme summary @leojonathanoh (#74)

v2.11.4 🌈

Changes

This releases fixes a bug where page attachments references would be syntactically incorrect in the final markdown if the attachment file name contains certain special characters reserved for markdown.

🐛 Bug Fixes

• Fix: Fix inserted attachment names not being markdown-encoded in final markdown @leojonathanoh (#73)

v2.11.3 🌈

Changes

This release fixes a bug that causes conversion to stop when an empty Section Group or Section is encountered in a notebook.

🐛 Bug Fixes

• Fix: Fix bug where conversion would terminate on an empty Section Group or Section @leojonathanoh (#69)

v2.11.2 🌈

Changes

This release addresses a critical regression introduced in v2.11.0 that led to incorrect markdown document file names. It is recommended to use this version instead of any prior v2.11.x versions.

🐛 Bug Fixes

• Hotfix: Fix markdown documents being converted with wrong file names @leojonathanoh (#68)

v2.11.1 🌈

Changes

This release fixes an bug in v2.11.0 where some identically-named pages within a section were not converted because their file name(s) were not suffixed with an increment (e.g. my-page.md, my-page-1.md, my-page-2.md). It also fixes a bug affecting v2.11.0 and all previous versions where each identically-named page within a notebook did not generate a fully unique .docx intermediate file and hence if a user used $usedocx = 2 (i.e. use existing .docx files), might have been converted from a .docx of another identically-named page leading to wrong markdown content.

It is recommended to use v2.11.1 immediately to ensure pages in notebooks are reliably converted.

🐛 Bug Fixes

• Fix: Generate fully unique .docx file for each page of a notebook @leojonathanoh (#60)
• Fix: Fix identically-named pages within a section not being converted into a uniquely named .md file @leojonathanoh (#59)
• Fix: Add missing Set-StrictMode in entrypoint @leojonathanoh (#62)

📝 Documentation

• Docs: Update readme summary and configuration descriptions @leojonathanoh (#63)

v2.11.0 🌈

Changes

This release focuses on adding the ability to convert pages in all nested section groups, in contrast to the limit of 5 nested section groups in previous versions. A new configuration option dryRun is added, which when paired with calling the script with the -Verbose switch can greatly help a user quickly find their best configuration settings. Configuration options are now validated, and the tool will refuse to run any conversion unless all values are valid. Logging is enhanced for better clarity, and user configuration is shown on tool initialization.

Notably, the keepPathSpaces configuration option is now removed because it has not been working reliably, and has shown to complicate the conversion process.

With newly added unit tests, this tool should be working for most powershell environments on Windows, and new features may be added more easily in future without breaking existing tool behavior.

-ErrorAction now properly controls whether the script error is terminating.

🚀 Features

• Feature (configuration): Add option to choose whether to do a dry run @leojonathanoh (#57)
• Enhancement: Perform conversion configuration and conversion simultaneously @leojonathanoh (#52)
• Enhancement: Add support for conversion of pages in all nested section group levels @leojonathanoh (#49)
• Enhancement (configuration): Improve configuration validation and show configuration on init @leojonathanoh (#51)
• Enhancement (ci): Add unit tests @leojonathanoh (#53)

🐛 Bug Fixes

• Fix: Fix relative paths when using option to prefix subpages @leojonathanoh (#56)
• Fix: Fix bug where non-existing docx file was attempted to be removed @leojonathanoh (#58)

🖊️ Refactors

• Refactor: Separate conversion configuration from conversion @leojonathanoh (#50)
• Refactor: Move code into individual functions @leojonathanoh (#48)
• Refactor (ci): Disable publish-draft-release job in github workflows @leojonathanoh (#55)

🗑 Reverts

• Revert (configuration): Remove option to choose whether to keep spaces in file and folder names @leojonathanoh (#54)

v2.10.0 🌈

Changes

This release adds an option to use a config.ps1 instead of entering configuration via interactive prompts. It adds support for Powershell core up to 7.0, and some useful warning messages for missing dependencies. A newline is now added between the document title and the timestamp in markdown (if including timestamps which is enabled by default).

🚀 Features

• Feature: Add support for declarative configuration using config.ps1 @leojonathanoh (#45)
• Enhancement: Add support for Powershell core < 7.1 for Windows @leojonathanoh (#43)
• Enhancement: Add newline between document title and timestamp @leojonathanoh (#42)
• Enhancement (logs): Add warning about missing onenote assemblies on Windows @leojonathanoh (#44)
• Enhancement (configuration): Enhance appearance of interactive configuration prompts @leojonathanoh (#46)

🐛 Bug Fixes

• Fix: Fix broken attachment relative paths @leojonathanoh (#47)

v2.9.2 🌈

Changes

This release further addresses broken attachment paths in markdown that was not sufficient in v2.9.1.

🐛 Bug Fixes

• Fix: Fix broken attachment relative paths @leojonathanoh (#47)

v2.9.1 🌈

Changes

This release fixes an issue with broken attachment paths in markdown that might have affected some older versions depending on the user's pandoc version.

🐛 Bug Fixes

• Fix: Remove duplicate $PSDefaultParameterValues @leojonathanoh (#39)
• Fix: Fix media paths not being replaced with relative paths @leojonathanoh (#40)
• Fix: Add error message when no notebooks are found @leojonathanoh (#37)
• Fix: Add normalization of the notes destination path to have no trailing slashes or backslashes @leojonathanoh (#41)

📝 Documentation

• Docs (readme): Update credits section @leojonathanoh (#38)