Repository navigation
Releases
SwiftMD 1.2.0
SwiftMD 1.1.0
Markdown mathematics
SwiftMD 1.1.0 updates SwiftGFM to 1.1.0 and prepares the opt-in Markdown mathematics profile distributed by Swift-MD-Adapters 1.2.0. Inline $...$ and display $$ blocks are rendered with KaTeX to embedded MathML. Existing math fences remain supported. Enable the profile explicitly with recognizeMath: true or CLI --markdown-math; the standard SwiftGFM-compatible Core path remains unchanged.
The adapter mirror also retains the experimental DOCX projection. SwiftHTML 0.1.1 supplies the optional HTML backend. JavaScriptCore is used on Apple platforms; Linux requires a trusted Node executable. The generated MathML and SVG do not require JavaScript in the viewing page.
The mathematics profile excludes code, table cells and image descriptions, and rejects unsafe raw HTML, NUL and unclosed display blocks. Renderer failures preserve escaped input with diagnostics. See the math profile, security contract, and third-party notices. No general HTML or SVG sanitizer is claimed.
SwiftMD 1.0.1
SwiftMD 1.0.1 tags source commit bc18264c1752c06c5da5c2c6904931e9eda366c2. The Core runtime and manifest are unchanged from 1.0.0; the optional DOCX adapter was added in the source repository.
The separately generated SwiftMD Adapters 1.1.0 package is intended to provide the experimental SwiftMDDOCX product. It projects the SwiftGFM AST to editable WordprocessingML and an in-memory DOCX ZIP. It supports paragraphs, headings, inline formatting, lists, simple tables, code, A4/Letter, and configurable spacing. Links are visible text with their destinations; images and raw HTML fail explicitly. Math and Mermaid code fences are labelled source in DOCX, not rendered as Office Math or diagrams. See the DOCX adapter documentation.
The HTML adapters continue to support highlighting, KaTeX MathML for math fences, and Pele SVG for mermaid fences. Inline and $$ mathematics are not part of this release. SwiftGFM 1.0.1 and Swift-Highlight 1.0.1 remain pinned; the Core has no optional renderer dependencies.
On macOS arm64, six DOCX tests passed; Word 16.115.1 opened, saved and reopened a document without Compatibility Mode. GitHub-hosted Linux CI passed the DOCX, Core, integration, supervisor and archive jobs for this commit. A public-dependency candidate passed the real three-renderer consumer and DOCX tests. The independent CodeQL Swift and Python scans completed with no findings; automated scanning is not an independent expert audit. Other platforms are not newly claimed as tested for the DOCX adapter.
This release does not provide a general HTML or SVG sanitizer, hard in-process resource isolation, Office Math conversion, embedded diagrams, or complete GFM conformance. See the security contract and process-isolation guidance.
SwiftMD 1.0.0
SwiftMD compiles Markdown to HTML through SwiftGFM and its pinned cmark-gfm parser. The Core package can be used independently; with no optional renderers its output matches SwiftGFM byte for byte for the same configuration.
The generated adapter package adds a single-call SwiftMDBundled API for Swift-Highlight, KaTeX block MathML and Pele diagram SVG. Apple platforms use JavaScriptCore; Linux requires a trusted, separately supplied Node executable. The generated MathML and SVG need no browser-side JavaScript. SwiftSoup library sources are vendored without upstream test fixtures, with their license notices.
The release supports math and mermaid code fences. Inline math, $$ block math, general HTML/SVG sanitization and full GFM conformance are not claimed. Review the security contract and process-isolation guidance for untrusted inputs. Automated scans are not an expert security audit or legal opinion.
See the documentation and example gallery.
Tested execution covers Linux x86_64, macOS arm64 and an iOS 27.2 simulator. The simulator is not a physical-device test. Other platform declarations and cross-builds alone are not runtime evidence.
SwiftMD 0.1.0
SwiftMD 0.1.0
SwiftMD renders Markdown to HTML through SwiftGFM and the pinned cmark-gfm backend. The core SwiftPM library preserves SwiftGFM's output bytes for the same configuration and requires no Node or browser.
This source release also includes experimental optional adapters and a CLI for Swift-Highlight, KaTeX block mathematics to MathML, and Pele Mermaid diagrams to SVG. MathML and SVG are precomputed and require no client-side JavaScript for display. The optional adapter mirror and CLI binaries are not published as part of this release; build them from the source checkout.
Explore the documentation and example gallery.
Inline and $$ mathematics are not implemented. The output is not a sanitizer; SVG validation and Linux process isolation have documented boundaries and have not received an independent security audit. Full GFM conformance is not claimed. Review the security and license notes and process isolation notes before deployment. Earlier Git history contains two removed fixtures whose individual rights remain unresolved.