Release History
MarkShup 1.5.4 (2026-08-25)
Lists with a little more backbone
What's been fixed?
- Headings in list items now render correctly.
What's been improved?
- List items now correctly support thematic breaks and nested block quotes.
MarkShup 1.5.3 (2026-08-25)
Heading in the right direction
What's been improved?
- Adjusted heading sizes in the default stylesheet for a more balanced hierarchy.
MarkShup 1.5.2 (2026-08-18)
Time for styles to get in-line
What's been fixed?
- Bold and italic text can contain inline code without rendering emphasis markers literally.
What's been improved?
- Added mixed-style list examples to the showcase for inline code within emphasis.
MarkShup 1.5.1 (2026-08-15)
More switches, more control
What's new?
--copy-filesand--no-copy-filescontrol whether referenced local files are copied to the output.--detect-imgand--no-detect-imgcontrol Smart Image Bundle detection.--default-cssand--no-default-csscontrol the built-in stylesheet.
What's been improved?
- The new options can be overridden and restored in descendant template directories.
MarkShup 1.5 (2026-08-11)
The right image for every display and browser
What's new?
- Smart Image Bundles support neutral variants alongside light and dark variants.
- Smart dashes convert
--to en dashes and---to em dashes (markshupstyle only).
What's been improved?
- Improved selection of color schemes, resolutions, and image formats.
MarkShup 1.4 (2026-08-08)
Keep MarkShup up to date the easy way
What's new?
- Installed MarkShup copies can update within or across major release lines.
overrides.txtcan replace selected command-line options in template folders.--strip-fragmentcan remove an exact fragment from HTTP(S) links.--js-helper-modecan select local Mermaid helpers or a pinned CDN bundle.
What's been fixed?
- References outside the source and output directories are no longer copied.
- Broken references are reported after every page has been generated.
MarkShup 1.3.1 (2026-08-03)
A more comfortable reading experience
What's been improved?
- Added high-contrast mode support for light and dark themes.
- Tweaked the default light and dark mode foreground and background colors.
- Prevented the default stylesheet from changing image backgrounds.
MarkShup 1.3 (2026-07-30)
Images for every display
What's new?
- Smart Image Bundles for light and dark
.imgdirectory variants. - Support for image variants at 1x, 2x, and 3x resolutions.
- Support for multiple image formats with automatic format selection.
- Optional
alt.txtfiles for image alternative text. --disable-imgoption to disable automatic image detection.
MarkShup 1.2 (2026-07-22)
Embedded HTML may also reference files
What's new?
- Copies and mangles files referenced by inline HTML.
What's been fixed?
- Numbered headers being mistaken for lists.
MarkShup 1.1 (2026-07-22)
Keep your links intact
What's new?
- Copies local files referenced by Markdown documents to the generated output.
--recursiveoption to convert Markdown files in input subdirectories.
What's been improved?
- Applies name mangling to copied files and folders.
- Rewrites links to copied files, including links with query strings and fragments.
What's been fixed?
- Prevents copied files from being written outside the output directory.
MarkShup 1.0 (2026-07-22)
Ready for Prime Time
What's new?
- Footnotes.
- Common GitHub-style emoji shortcodes.
- Mermaid diagram code blocks, rendered offline with the optional
--js-helperoption.
What's been improved?
- Fenced code blocks carry their language classes, allowing syntax highlighting.
What's been fixed?
- CommonMark parsing of nested, mixed, and word-internal emphasis delimiters.
- Code spans containing backticks.
- Link and image titles, nested parentheses in destinations, and rich alt text.
- Fenced-code indentation and length.
- Ordered-list start numbers and marker-width nesting.
- Nested block constructs in list items.
- Backslash escaping for all ASCII Markdown punctuation.
- Tag-specific HTML block termination.
MarkShup 0.9.3 (2026-07-20)
Choose your dialect
What's new?
--flavoroption to choose Common Markdown, common extensions, extended features, or all MarkShup features.--option to end option processing, allowing input paths that begin with a hyphen.- Support for automatic links, heading links and explicit heading identifiers.
- Support for nested block quotes, task lists, definition lists, and image titles.
- Support for inline and indented code blocks, including tilde-fenced code blocks.
- Support for highlighting, single-, double-, and triple-tilde strikethrough, subscript, and superscript.
- Support for GitHub-style note boxes.
What's been improved?
- Rendering of inline HTML, block quotes, hard breaks, closing ATX headings, and escaped table pipes.
- Default Markdown stylesheet, including heading sizes, task lists, note boxes, and table styling.
What's been fixed?
- Malformed UTF8 doesn't cause a parse fail, it's just copied byte-for-byte into the output file.
MarkShup 0.9.2 (2026-07-18)
Sometimes you just want embedded HTML
What's new?
- Added support for embedded HTML in Markdown documents.
What's been improved?
- Versioned release archives with the MarkShup version number.
MarkShup 0.9.1 (2026-07-17)
Making template customization more flexible
What's new?
- Added
--meta NAME VALUEfor adding metadata tags to generated documents. - Added
meta.txttemplate support with inheritance. - Added
--,+, and--+markers for combining template and command-line assets.
What's been improved?
- Improved inheritance for headers, footers, stylesheets, favicons, and JavaScript.
- Prevented duplicate command-line links when templates inherit assets.
- Improved documentation, release history, and download pages.
MarkShup 0.9 (2026-07-16)
Preview Release
This is the first, fully functional release but it may still contain some minor bugs, so use with care.