ContentsKnown issues

HelpWriting notes

Export / import (PDF, Markdown)

Describes monthlet 1.3.1.

You can export notes to external formats and import external Markdown.

  • Export: PDF (for printing/sharing) or Markdown (to take notes into other tools). Markdown export adds YAML frontmatter (title / tags / created / updated / pinned / archived) and keeps heading levels H1–H6. Charts export as their underlying data table, diagrams as ```mermaid, math as $$…$$, callouts as `> [!type]`, and video/audio/embeds as links — nothing is silently dropped (it round-trips back on import). The frontmatter starts with a `type` key (`type: Note` if the note has none), so the file reads as OKF (Open Knowledge Format).
  • Export to Word (.docx): from the note's "…" menu choose Export → Word (.docx) to get a document you can open in Word. Headings, paragraphs, bulleted and numbered lists, checklists, quotes, code, tables (including merged cells), images, links, bold and italic, text color and underline come in as editable Word formatting. Charts, diagrams, math, stat cards, progress, kanban boards and similar blocks come in as images that look the same as in the note (they can't be edited in Word).
  • Export a folder or the whole vault as Markdown: right-click a folder in the sidebar → "Export as Markdown…", or choose File → "Export Vault as Markdown…", then pick a destination folder outside the vault. monthlet creates a new folder there and mirrors the structure: notes become .md files, spreadsheets become one .csv per sheet, and images and attachments are copied as they are. Links between notes are rewritten to point at the exported .md files, so you can open that folder as an Obsidian vault and the links and images keep working. Charts and diagrams are exported as tables and Mermaid, as above. If some links point outside the exported folder or an attachment can't be found, the summary at the end tells you how many. A note whose exported name would be index.md or log.md gets a name like "index (monthlet).md" instead, because OKF reserves those names for the listing and the change log.
  • Import: convert an existing Markdown file, or a folder of Markdown files, into monthlet notes. For folder import, turn on "Keep file names" to convert without renaming by the content title — handy for keeping date-style names (e.g. Obsidian YYYY-MM-DD.md → YYYY-MM-DD.html). You can start an import from the sidebar import button, or from an open note's top-right ⋯ menu → "Import Markdown / Excel / Evernote (file / folder)" (it imports into the folder selected in the sidebar; if none is selected, into the open note's folder, otherwise the top of the vault — so a folder with no notes in it yet can be chosen too). On Windows, the import button / "Import Markdown / Excel / Evernote (file / folder)" menu asks you to choose "Import file…" or "Import folder…" (on macOS one dialog lets you pick either a file or a folder).
  • Import from Evernote: choose an Evernote export file (.enex) and each note in it becomes a monthlet note. Title, created date, tags, headings, paragraphs, lists, checklists, tables, images and attachments, code blocks, bold/italic/strikethrough, text color, underline, links and merged table cells carry over. Background colors and highlights can't be shown in notes, so they are removed and the count is shown after the import (a merge that runs down from the header row is also split, with the text in the top-left cell). Images and attachments are saved in the same folder as the notes. An .enex with two or more notes goes into a new folder named after the file (the Evernote notebook name). If you have many notebooks, put the exported .enex files in one folder and import that folder: each notebook becomes its own folder. The updated date is not kept; it becomes the time of the import. Nested lists keep every item but become a single level. Links between notes that start with evernote:// keep only their text. An .enex larger than 300 MB can't be imported; split the notebook in Evernote and export it in parts.
  • Mermaid promotion: when imported Markdown contains a ```mermaid flowchart (flowchart / graph) or mindmap, it is automatically converted into a diagram block, carrying over node shapes (rectangle, rounded, diamond, circle) and edge labels. Unsupported syntax (e.g. sequence diagrams) is imported safely as a code block.
  • Callout promotion: Obsidian callouts such as `> [!note]` / `[!tip]` / `[!warning]` / `[!danger]` are converted into matching callout blocks (when the title is omitted, the type name becomes the title). Plain blockquotes (`>`) are imported as quote blocks as before.
  • Moving from an Obsidian vault: what comes over is your notes (Markdown), the folder structure, frontmatter (tags plus other keys such as aliases are kept), [[note]] and [text](note.md) links (rewritten to point at the imported notes, and aliases are used to resolve them), attachments such as ![[image]] (copied next to the notes), Mermaid diagrams, callouts, ==highlights== and footnotes ([^1] is shown as a superscript number). What does not come over: plugin queries such as Dataview (kept as code, not run), and embedded notes ![[note]] (they become links). Canvas files (.canvas) come over as one note each, drawn with the cards, group frames, lines and colors where they were (view only; you can’t move them in monthlet). File cards become links to the imported notes and images.
  • Moving from Bear: in Bear, select the notes you want to move, choose File → Export notes…, pick Markdown as the format and turn on Export attachments. Import the exported folder into monthlet: text, headings, lists, checklists and images come over. #tags in the text also become note tags (#parent/child stays one tag; a closed tag with spaces such as #two words# becomes one tag with the spaces replaced by _). A TextBundle export is also imported as one note per bundle. Created and modified dates become the time of the export, because Bear's export does not keep the original dates.
  • Moving from Craft: in Craft's All Documents, select the documents you want to move, right-click, choose Export and pick Markdown as the format (TextBundle export is only available on Craft's paid plan). Import the exported folder into monthlet: text, headings, lists, checklists and images come over. #tags in the text also become note tags. Created and modified dates become the time of the export, because Craft's export does not keep the original dates.
  • List import: nested (indented) bulleted and numbered lists are imported as one list with their hierarchy kept (including combinations such as a bulleted parent with numbered children). In a note, press Tab in a list item to indent it and Shift+Tab to outdent it (Backspace on an empty indented item outdents it first). Nested checklists are flattened: child items become items indented with a full-width space, and keep their checked state. A list that mixes tasks (- [ ] / - [x]) with plain items becomes one checklist, with the plain items unchecked. Paragraphs, tables, code blocks, and quotes indented inside a list item are imported right after that item as regular blocks (the list is split there). Numbered lists keep their starting number (for example, a list that starts at 4.).
  • Wikilink resolution: Obsidian `[[Note]]` / `[[Note|alias]]` links are turned into monthlet internal links (click to open that note) by matching the name against the imported notes and your existing notes. Folder import also resolves cross-links within the folder. Links to notes that are not found are kept as `[[...]]`. `[[Note#Heading]]` drops the heading anchor and links to the note itself.
  • Embed import: Obsidian embeds such as `![[image.png]]` / `![[clip.mp4]]` / `![[audio.mp3]]` copy the attachment file from the source into the note’s folder and display it as an image / video / audio block. Non-media attachments (e.g. PDF) become a clickable link. `![[Note]]` (note embeds) fall back to an internal link, since monthlet has no transclusion block (same resolution as wikilinks above). If the attachment cannot be found or copied, it still becomes the same image / video / audio block (or link for non-media) and is counted as a missing reference in the import result, so you can relink it from the note’s attachment bar.
  • Missing references: The import result may show a count of missing references (images and similar). The notes themselves were imported, but files their body points to are not present in the destination. The usual cause is that the file is not anywhere under the source folder (both Obsidian embeds such as `![[image.png]]` and standard `![alt](image.png)` references are counted the same way). Open the note and the attachment bar at the bottom marks them as not found, so you can relink from there.
  • Files not imported: Folder import only brings in Markdown (.md / .markdown), Obsidian Canvas (.canvas) and Evernote export (.enex) files. If the folder also holds documents such as Excel (.xlsx), CSV, text, Word or HTML files, the result says which files were not imported, with a count per file type. Excel and CSV files can be imported one at a time as spreadsheets. Attachments such as images and PDFs are copied along with the notes that reference them, so they are not counted here.
  • Math import: a standalone `$$ … $$` block becomes a math block rendered beautifully with KaTeX. Inline `$ … $` mixed into text is also rendered as math. Currency like `$5` is not treated as math.
  • Unknown frontmatter keys are preserved: keys other than title / tags / created / updated / pinned / archived (e.g. Obsidian’s status, aliases, related, cssclass) are not discarded on import and are written back out when you export to Markdown, so a round trip keeps your metadata. Flat values, booleans and lists (arrays) are supported, and nested values (such as OKF’s sources and generated) are kept too. A `[[Note]]` written in something like related is kept verbatim as text (links inside frontmatter are not turned into internal links). Keys with non-English characters or spaces (such as “due date”) are kept as they are. Lines that cannot be read as YAML are not imported, and the import tells you how many there were when it finishes.

monthlet is free on macOS and Windows.

Download monthlet