Binary Markdown 0.2.1
Version 0.2.1 integrates equation editing, YAML front matter and managed tables
of contents, improved export presentation, Windows validation, and a clearer
documentation layout. PR #8
records the integration and its automated validation evidence.
Editor and export changes
- Edit inline and display equations while preserving their source delimiters;
support multiline expressions and native math in DOCX/EPUB. - Keep inline equation edits cancellable during background outline updates and
document synchronization, including after undoing a previous equation edit. - Preserve YAML front matter in a collapsible source editor. Refresh managed
tables of contents on save and retain linked heading destinations in exports. - Style editable DOCX code blocks and add optional language tabs to DOCX/PDF.
Use the dedicated extension settings shortcut to configure export appearance. - Default PDF pages to readable white backgrounds, with an option to retain the
editor theme. Fill page margins and unused page areas consistently. - Preserve newer edits when delayed file-watcher notifications arrive after a
save. Serialize webview replacements so rapid language/layout changes finish
with the selected settings. - Export locally on Windows, with executable discovery, drive/UNC paths and
Unicode resource paths covered by platform validation.
Platforms and validation
The required CI workflow builds one identified
VSIX and validates those bytes on Ubuntu x86-64, macOS ARM64 and Windows x86-64,
plus the minimum VS Code 1.85.0 on Ubuntu. Gates include real converters,
installed-extension scenarios, output integrity, cancellation/failure handling
and browser regressions without retries. The Windows guide
describes platform-specific tooling and the validation boundary.
Remote-SSH/WSL, browser VS Code, Windows ARM64 and standalone installers remain
outside the validated export scope. The Electron source version is aligned;
this does not establish installer compatibility.
Updating and documentation
The extension retains BinaryOutlook.binary-markdown, its command/settings IDs
and stored outline preferences. Install the selected VSIX, then reopen editor
tabs or reload VS Code. See migration guidance.
Maintained guidance lives in docs, dated findings in
reports, version notes here, and completed plans in
archive. Reading indexes and offline link/privacy-pattern
checks help keep the published material navigable and public-safe.
Known limitations
Generated TOC labels show equation source as plain text even when the headings
render math. HTML/PDF disclose that literal notation. DOCX pagination can move
long code blocks to a new page to keep their language footer attached. Target
readers, including Microsoft Word, still need visual review; automated checks
do not establish identical layout in every reader. Export remains experimental;
see export help for fallback behavior and tool setup.
The published release page
identifies available downloads, source and checksums. A versioned source commit
or passing CI run does not itself publish a release.
Source commit: 1a93cc3b089da4bdde57aaab18e39fb8ebe7e0cc
Validation: https://github.com/BinaryOutlook/binary-markdown/actions/runs/34874665057 (attempt 1).
The attached VSIX is the exact artifact validated by that run. Check SHA256SUMS before installation.