Binary Markdown 0.2.1

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.

Binary Markdown 0.2.0

Binary Markdown 0.2.0

This release introduces experimental document export, the 01 / MD identity, and an identified build and release process. The extension remains free and open source, with source access and development builds treated as intended ways to use it.

• Export saved Markdown to standalone HTML, rendered PDF, editable DOCX or EPUB. Use the sharing-arrow menu beside the VS Code button. Pandoc is required for DOCX/EPUB; a compatible user-installed Chrome/Chromium/Edge is required for PDF. HTML needs no separate converter.
• Save beside the source with safe filename collisions: the completed export's final eight SHA-256 hexadecimal characters, then numbered suffixes; identical hash-named files are reused without overwriting existing work.
• Follow actual progress stages, cancel active jobs, retain original-resolution supported assets, and receive visible fallback warnings. HTML/PDF preserve supported editor appearance; DOCX/EPUB emphasize editable structure.
• Use Binary Markdown: Copy Build Information to report the exact source revision, local changes and host environment. Reports from older development commits are welcome. See releases and support.
• Adopt the supplied 01 / MD artwork and AGPL-3.0-or-later for current development. Earlier MIT versions, inherited notices and third-party licenses are preserved; see licensing and branding.
• Keep BinaryOutlook.binary-markdown and its settings/storage identifiers when updating from 0.1.0. Reopen editor tabs or reload VS Code after installation. Older ID migration is separate.

The release scope is local desktop VS Code on macOS and Ubuntu. Required automated validation checks the same VSIX on Ubuntu/macOS and in the declared minimum VS Code 1.85.0; evidence and any remaining manual-reader limitations are linked in validation. Windows export, Remote/web hosts and standalone installers remain future work.

Remote-SSH export is not yet supported. Unsupported windows show the restriction in the menu and disable all formats, including HTML, without suggesting that installing Pandoc or a browser will fix it. To export now, copy the Markdown file and its referenced assets locally and open them in desktop VS Code on macOS or Linux.

Export is intentionally an initial version: simple pagination can leave blank space; HTML/PDF retain dollar-math, TOC and footnote syntax as visible source with warnings; Pandoc layout differs from browser output. Detailed fallback explanations remain English. Custom destinations, templates, compression and unsaved export are future work. See export help.

Download the VSIX, matching source, build information, validation evidence and checksums attached to this release. No Marketplace account or payment is needed to install the VSIX. Official releases follow completed validation, without a fixed release schedule.

Source commit: f84dd0d1d091824665c6f4ba52f51ec3725010be

Validation: https://github.com/BinaryOutlook/binary-markdown/actions/runs/34610035955 (attempt 1).

The attached VSIX is the exact artifact validated by that run. Check SHA256SUMS before installation.

Binary Markdown 0.1.0 — Test release

First public test release of Binary Markdown Editor, independently maintained by BinaryOutlook. This MIT-licensed fork builds on Any Markdown by raggbal and contributors, based on upstream commit 82487429. Most editor functionality is inherited; acknowledgments preserve that provenance.

Install

1. Download binary-markdown-0.1.0.vsix under Assets below.
2. In VS Code, open Extensions → … → Install from VSIX… and select the file.
3. Open a Markdown document and choose Reopen Editor With… → Binary Markdown.

No terminal commands are needed to install it. The accompanying .sha256 file provides the package's SHA-256 checksum.

The extension ID is BinaryOutlook.binary-markdown. Installation leaves your default Markdown editor unchanged. Commands, settings, and editor registration use their own Binary Markdown names. Existing preferences and remembered outline state are not automatically imported; see the migration guide, including guidance for removing the obsolete BinaryOutlook.any-markdown test build.

Changes in this fork

• Preserve newlines, indentation, and meaningful blank lines when copying code blocks, incorporating the work proposed upstream in PR #8.
• Remember outline visibility per file or globally, with a configurable initial state, incorporating PR #9. Opening the outline does not mark the document as edited.
• Align the extension and desktop sources with Binary Markdown branding and identifiers.
• Add current installation, settings, migration, and contribution documentation, while preserving the upstream presentation and release history in an archive.

Validation and feedback

• Extension and Electron sources compile successfully.
• 61 focused browser tests and 10 unit/registration checks passed.
• A native VS Code coexistence smoke test passed alongside Any Markdown 0.195.392, covering activation, commands, independent settings, editor opening, and unchanged default associations.
• Lint completed with 10 existing warnings and no errors.

Copy-and-paste and outline behaviours were fully tested on VS Code 1.136.0 / macOS before the naming migration. The renamed build needs further manual testing. The full browser suite, desktop installers, and other editor environments have not been validated for this release.

Use the manual test document and report issues in this fork. Include a small reproduction and editor/OS versions; omit personal paths, usernames, and private documents. Contributions are welcome under MIT.

This is a GitHub prerelease for testing. VS Code Marketplace and Open VSX publication are pending. Other editors may install the same VSIX if their extension APIs are compatible.