Export

It'd be a shame to keep the piece you worked so hard on all to yourself! Let me show you how to wrap it up neatly to share with friends, or print it out beautifully to keep. 🎁

← Home: ObsiKO 101

How Should You Export? (Formats) 💌

• PDF: The cleanest, most versatile option! Perfect for printing or sharing with others.
• DOCX: Export as a Word (.docx) document. Handy for pasting into company templates or co-editing with others.
• HWPX: Export as a Hangul (Hancom Office) document — an experimental feature. Headings and bold/italic carry over, lists become Hangul's real bullets and paragraph numbering (●·○·■, and 1. → 가. → 1) as they nest; a list that starts again after other text restarts at 1), page numbers appear at the bottom center as "- 1 -", and tables keep their alignment (:---), content-sized columns and a shaded header row (plus <br> line breaks inside a cell). Images come through as real pictures whether they sit on their own line, mid-paragraph or inside a table — inline drawings (SVG) included. Links keep their text only; ObsiKO-only blocks like charts and math go in as code (nothing disappears). Opens in Hangul 2020 or later.
• EPUB: Turns your note into an e-book (.epub) you can read on any e-reader. → E-book & Web Novel Viewer
• HTML: Great for posting on the web or keeping the pretty styling intact! (It comes with ObsiKO's own styling and safe security settings baked right in.)
• ZIP (.md): Zips up your original Markdown files as-is — great for backing up or moving everything at once.
• Wiki: Converts your note into wiki markup (Namu Wiki, MediaWiki, SCP). More on this just below! 📚
• Print: When you want actual paper in your hands! (No printer? You can always choose 'Save as PDF' in the system print dialog — you knew that, right? 😉)

Export Options ⚙️

• Export rendered: Turn it on to export the note looking just like its styled appearance; turn it off to export the raw Markdown text instead.
• Include title: Choose whether to put the note's title at the top of the document.
• Merge into one file: When exporting multiple notes as PDF or HTML, you can combine them into a single file (printing is always merged).

Bulk Export: Better Together 📚

• Open the export window and the file you currently have open is already checked by default!
• The file list shows only the files in the folder currently selected in the sidebar (if no folder is selected, it shows the whole vault). That makes it easy to export just the bundle you want, even if you have a mountain of files!
• Just check the boxes next to any other files in the list, and you can export them all together at once.
• Print a bundle of files together and don't worry — every time the file changes, it neatly breaks onto a new page automatically.

🗺️ Pick a mind map (.canvas) and the format switches to ZIP. A canvas is a drawing board, not prose, so it can't be rendered to PDF or HTML. The moment one is selected the format flips to ZIP (originals) and the other buttons lock. Want just the documents as PDF? Hit the Exclude canvas button above the list! (To export a mind map as a picture, use the export inside the mind map screen → Mind Map)

Paste Straight Into a Wiki — Wiki Markup Export 📚

Writing an article on Namu Wiki, posting your notes to Wikipedia or a company wiki, submitting to the SCP Foundation wiki — that tedious job of rewriting every bit of syntax by hand is now done for you.

1. Pick the Wiki format in the export window,
2. and three choices appear right below: Namu Wiki · MediaWiki · SCP (Wikidot). Pick one,
3. then hit [Copy wiki markup] — done! Paste it straight into the wiki's editor. 📋

• The syntax you picked is remembered for next time.
• [Save file] saves it with the syntax name attached, like note-name.namu.txt.
• If you selected several notes, the button becomes [Save as ZIP]. A wiki takes one page at a time, so they're kept as separate files rather than merged (folder structure included).

What Gets Converted? ✨

Headings, bold, italic, strikethrough, lists, quotes, tables, code blocks, links, footnotes and math are all turned into each wiki's own syntax. Since every wiki has its own rules, these are handled for you too:
- On MediaWiki, # means a numbered list rather than a heading, so Markdown # headings are stepped down to == Heading == (the page name itself is the top-level title).
- Namu Wiki needs a space before the * in lists, and sections usually start at ==. All those little rules are matched for you.
- On SCP (Wikidot), internal links take three brackets ([[[Page|label]]]) and headings use +.
- If your text happens to contain wiki symbols, they're neutralised so the page doesn't break.

Nothing Disappears Quietly 🙋

So you never paste something in and think "wait, where did that go?", you're told what happened right after copying. (For example: Copied · 2 image(s) need uploading · highlight colour dropped)
- Images and attachments: a wiki needs the file uploaded to that wiki, so the file name is placed for you and you're told how many you need to upload.
- ObsiKO-only blocks like charts and mind maps: wikis don't have these, so the source is kept as-is (nothing vanishes).
- Frontmatter (properties): the values are left out and you're only told which properties were dropped — private notes shouldn't ride along into public wiki source.
- Block IDs: not deleted, but turned into that wiki's anchor (bookmark).
- When several notes come back as a ZIP, _obsiko-wiki-report.txt is included with the notes listed one by one.

💡 Every wiki is configured a little differently (math, for instance, only shows up if the MediaWiki Math extension is enabled). It's worth checking the preview once after pasting.

Slides, Snapped Just as They Are! 📸

• Turned a document into a presentation? Then exporting it as PDF or HTML preserves that gorgeous slide look exactly as-is! → For presentation prep, see Making Presentations

Diagrams and Charts, Rendered as Images Too! 📊

• Mermaid diagrams and chart data charts (bar, line, pie, radar, heatmap, Venn, fishbone, and 20+ more types) that you put in your document also get exported as actual images (SVG) rather than raw code, both in PDF and HTML.
• The colors follow whatever theme you're using at the moment of export, and the images are embedded whole inside the document with no external connections needed — so it looks the same wherever you open it. → For how to make them, see Advanced Markdown

One link and they can read it — Share to the web 🔗

Instead of sending a file, you hand over a single link. Whoever receives it reads it right in a browser — no app to install, no account to create.

• Where: the share button on the tab bar, or the command palette (⌘P) ▸ Share to the web. You can publish a note (.md), a mind map (.canvas) or a data table (.base).
• You connect a GitHub account once (no account? You can create one for free in the approval window). The text goes into a secret Gist in your own GitHub, and the viewer on obsiko.com fetches and draws it — nothing is stored on an ObsiKO server.
• It looks exactly as it does in the app — theme colors, callout boxes, highlights, checkboxes, tables, YouTube and map cards. Images are embedded in the document, so there is nothing else to upload.
• Linked notes can come along: notes that the [[wikilinks]] in the body point to can be published together (flip between them from the table of contents on the left).
• Edited since? Press “Publish again to the same address” — the same link updates (and you are told when the content has changed since you shared it).
• To stop, press “Stop sharing” — it is removed from the web and your original note stays untouched (copies someone already took cannot be recalled).
• Everything you published is listed in Settings ▸ Web sharing, where you can open or delete each one. It works in the browser version too.

⚠️ Anyone with the link can read it. It is not indexed by search engines (secret Gist · noindex), but treat the address itself as the key. Don't publish anything you couldn't show a stranger.

💡 If what you actually want is to keep writing in the same vault across devices, that is sync, not sharing. → Settings & Themes

It Varies a Little by Device 📱💻

• Desktop (Mac/Windows): A single file brings up a save dialog right away; for multiple files, just pick a folder once and they'll all land inside it.
• Web browser: Files download one at a time, or hand off to the system print dialog.
• iPhone · iPad · Android: Apps here can't trigger a direct download or open a print dialog. Instead, we save the file straight into your vault! Open the saved file in your Files app or a browser to print or share it. → Platform Guide
• Choose PDF, HTML, or Print → saved as an HTML file (open that HTML and print it to get a PDF).
• DOCX, EPUB, and ZIP → saved with their own extensions (.docx, .epub, .zip) in the vault.

← Previous: Random Box · Home · Next: Web Clipper →