purpose | apply base 64 encoding to a string |
---|---|
input | a selection of titles |
suffix | optional: binary to treat input as binary data, urlsafe for URL-safe output |
output | the input with base 64 encoding applied |
Learn more about how to use Filters
Introduced in v5.2.6See Mozilla Developer Network for details of base 64 encoding. TiddlyWiki uses library code from @nijikokun to handle the conversion.
The input strings are interpreted as UTF-8 encoded text (or binary data instead if the binary
suffix is present). The output strings are base64 encoded.
The optional binary
suffix, if present, causes the input string to be interpreted as binary data instead of text. Normally, an extra UTF-8 encoding step will be added before the base64 output is produced, so that emojis and other Unicode characters will be encoded correctly. If the input is binary data, such as an image, audio file, video, etc., then the UTF-8 encoding step would produce incorrect results, so using the binary
suffix causes the UTF-8 encoding step to be skipped.
The optional urlsafe
suffix, if present, will use the alternate "URL-safe" base64 encoding, where -
and _
are used instead of +
and /
respectively, allowing the result to be used in URL query parameters or filenames.