Menu

Markdown Obfuscator - Zero-Width Hide & Base64 Blocks

Real reversible transformations. Hide text invisibly in zero-width Unicode characters, or Base64-encode paragraphs with a verifiable decoder. 100% browser-based.

Markdown Obfuscation Studio Reversible
Ready
Markdown Source 0 lines • 0 chars
Obfuscated Output 0 lines • 0 chars
🔒 Zero-Width Hide mode. The "Secret Text" below is encoded as invisible zero-width Unicode characters and inserted after the first word. The visible Markdown is unchanged, and the hidden payload survives copy-paste on most platforms.
Complete Guide to Markdown Obfuscation

What Markdown Obfuscation Actually Means

Markdown is plain text. It is designed to be readable, editable, and portable. Unlike JavaScript or CSS, there is no execution model, no control flow, and no syntax to scramble. This means "Markdown obfuscation" cannot mean what it means for code.

Two transformations are genuinely possible without breaking the format:

  1. Zero-width steganography — hide data invisibly in Unicode characters that render as nothing. The visible Markdown is unchanged; the hidden payload travels with the text.
  2. Base64 block encoding — replace readable paragraphs with Base64-encoded code blocks. The rendered output changes (prose becomes an unreadable Base64 string), and the transformation is fully reversible.

This tool implements both, plus the corresponding decoders. Every mode is verified by a round-trip test that decodes the output and compares it byte-for-byte to the original.

The Five Modes

ModeWhat ChangesRendered OutputReversible?
🔒 Zero-Width HideInvisible Unicode characters inserted after the first wordUnchanged✅ Via Zero-Width Decode
🔓 Zero-Width DecodeExtracts the hidden zero-width payloadN/AN/A
🧹 Zero-Width CleanRemoves every zero-width characterUnchanged (just cleaned)N/A
📦 Base64 EncodeParagraphs replaced with Base64 code fencesProse becomes Base64 text✅ Via Base64 Decode
📥 Base64 DecodeDecodes Base64 code fences back to proseRestored to originalN/A

How Zero-Width Steganography Works

Unicode contains several characters that occupy zero visual width — they render as nothing. The four most commonly used for steganography are:

CharacterUnicodeRole
Zero-Width Space (ZWSP)U+200BBinary 0
Zero-Width Non-Joiner (ZWNJ)U+200CBinary 1
Zero-Width Joiner (ZWJ)U+200DStart marker
Word JoinerU+2060End marker

Each byte of the secret text is converted to 8 bits. Each bit is mapped to a zero-width character. The resulting invisible string is inserted into the Markdown — after the first word of the document. The decoder does the reverse.

How Base64 Block Encoding Works

Base64 block encoding is a visible transformation. It replaces readable paragraphs with a code fence containing Base64-encoded text:

Before:
This release includes several improvements to the core engine.

After:
```mdobf:b64
VGhpcyByZWxlYXNlIGluY2x1ZGVzIHNldmVyYWwgaW1wcm92ZW1lbnRzIHRvIHRoZSBjb3JlIGVuZ2luZS4=
```

The rendered Markdown now shows a Base64 string instead of the original prose. A reader without the decoder cannot see the content. The decoder reverses it byte-for-byte.

This mode is safe for Markdown structure because it uses a code fence with a custom language tag. Headings, lists, tables, links, images, blockquotes, HTML blocks, and inline code are never encoded — only plain prose paragraphs qualify.

What This Tool Cannot Do

  • It cannot encrypt. Both modes are reversible encodings. Anyone with a decoder can recover the content.
  • It cannot hide secrets from a determined reader. Base64 is trivially decoded; zero-width is trivially extracted.
  • It cannot survive every platform. Gmail, Slack, Discord, and Twitter strip zero-width characters. Test first.
  • It cannot make Markdown unreadable at the rendered level while keeping it byte-identical. Either the rendered text changes (Base64 mode) or the source gains invisible characters (zero-width mode).

Fenced Code Block Protection

Markdown fenced code blocks (``` and ~~~) contain literal content that must not be altered. Every mode in this tool tracks fence state and never touches content inside a fence.

Inline code spans (`code`) are also preserved. Base64 block encoding skips paragraphs that contain inline code, links, images, or that begin with Markdown structural markers.

Round-Trip Validation

Every operation ends with a round-trip test:

  • Zero-Width Hide: the tool re-extracts the payload and verifies it matches the original secret exactly. It also verifies the visible text is byte-identical.
  • Base64 Encode: the tool decodes the output and compares it to the original Markdown byte-for-byte. If the decoded Markdown does not match, the tool refuses to show success.

The results panel shows Round-trip PASSED or Round-trip FAILED with the reason. No silent failures.

When to Use Zero-Width Mode

  • Watermarking generated documents — embed a provenance ID that survives copy-paste.
  • Content attribution — tag CMS-rendered fields with the document and revision ID.
  • Canary tokens — send the same text to N recipients with N distinct IDs; if the text leaks, the ID identifies the source.
  • A/B test tracking — tag visible content with the experiment variant.

When to Use Base64 Mode

  • Shipping Markdown previews — you want readers to see a scrambled block, not the actual prose.
  • Staging content — draft content that should be decoded only at render time.
  • Content gating — encode part of a document that should only be readable with a decode step.
  • Educational examples — demonstrate Base64 encoding with real Markdown.

When NOT to Use Either Mode

  • Never for secrets. Neither mode provides cryptographic protection.
  • Never for legal signatures. Both can be stripped or forged.
  • Never as a substitute for encryption. If confidentiality matters, encrypt first with gpg or age, then apply a Markdown mode.

Security Considerations

Markdown obfuscation is obfuscation, not security. It provides obscurity and reversible encoding, not cryptographic protection. The appropriate mental model is a watermark or a steganographic tag, not a lock.

Frequently Asked Questions

Does Zero-Width mode change the visible Markdown?
No. Zero-width characters render as nothing. The visible text is byte-identical to the original. Only the source bytes differ.
Does Base64 mode change the visible Markdown?
Yes. Encoded paragraphs are replaced with a code fence containing Base64 text. Rendered output shows the Base64 string, not the prose. This is intentional — it is the visible change that obscures the content.
Will the hidden text survive copy-paste?
Zero-width characters usually survive copy-paste but are stripped by some platforms (Gmail, Slack, Discord, Twitter). Base64 blocks survive copy-paste in all Markdown renderers because they are ordinary code fence content.
Is this encryption?
No. Both modes are reversible encodings. Anyone with a decoder (or the Base64 algorithm) can recover the content. Do not use for secrets.
How do I decode?
Use the matching decode mode: 🔓 Zero-Width Decode for zero-width payloads, 📥 Base64 Decode for Base64 blocks. Both verify the decoded output byte-for-byte.
What happens to my code fences?
They are preserved exactly. Both modes skip content inside fenced code blocks and inline code spans. Only plain prose paragraphs are eligible for transformation.
What happens to headings, lists, and tables?
They are preserved. Base64 encoding skips paragraphs that start with a Markdown structural marker (#, -, *, +, digits + ., >, |, or HTML tags). Zero-width hiding inserts after the first word, which may be inside a heading — but the heading rendering is unaffected.
Can I decode without this tool?
Yes. Zero-width payloads can be extracted with a script that filters ZWSP/ZWNJ/ZWJ/WJ characters and reconstructs bits. Base64 blocks can be decoded with any Base64 utility. This tool is a convenience, not a proprietary format.
Is my text uploaded to your server?
No. Everything runs in your browser using JavaScript. Your text never leaves your device.
Can antivirus detect this?
Some endpoint security tools flag zero-width characters as suspicious because malware has used the technique. Add a clear comment if distributing the file. Base64 blocks are less likely to trigger flags.
What is the maximum file size?
There is no hard limit, but files above 5 MB may cause browser slowdowns. For very large Markdown, use a command-line tool.
Does the seed affect the output?
Yes. The seed controls the position of the payload and, for Base64 mode, affects the code-fence marker if you use a custom variant. Different seeds produce different output bytes.
Can I hide more than one secret?
Zero-Width mode supports one payload per operation. Run the tool multiple times with different insert positions for multiple payloads.
Does it work with any text file?
Yes. The tool works on any UTF-8 text. It is labeled "Markdown" because Markdown is a common use case.
What is the Round-trip PASSED check?
After obfuscation, the tool decodes the output and compares it byte-for-byte with the original. If they match, "Round-trip PASSED" appears. If not, the tool reports the exact failure reason.

Related Tools