Apple Notes Exporter Pro · Troubleshooting

Apple Notes Checklist Not Exporting Right in Markdown? Here’s Why

Checklists are not on the short list of formatting Apple confirms survives its native Markdown export and import. Here is exactly what is documented, what is not, and how to keep checkbox state and indentation intact.

By Ram Velmurugan · Founder & Lead Developer, 1dot.ai

Verified against primary sources, Sept 2026·8 min read
Quick answer: There is no widely confirmed bug where an Apple Notes checklist simply fails to write to the exported Markdown file. What is documented is narrower and just as worth knowing: checklists are not on the short list of formatting Apple and independent reviewers confirm round-trips cleanly, headings, bulleted lists, bold and italic text, and links, and real users report checkbox state or list indentation breaking specifically when a Markdown checklist is imported back into Notes, especially one sitting directly under a heading or instruction line. Use standard checklist syntax, separate a checklist from a heading with a blank line, and check the result after importing.

Editorial note: 1dot.ai makes Apple Notes Exporter Pro, mentioned later in this guide. Every claim below is sourced to Apple’s own documentation, independent coverage of the feature, or a specific, dated forum thread, and where the evidence is a single report rather than something widely corroborated, that is stated plainly rather than rounded up into a bigger claim.

macOS 26 Tahoe and iOS 26 gave Apple Notes a real, built-in way to export and import Markdown files, a feature we covered in detail in our first look at what it does and doesn’t do, and which turned out to have a separate, more serious bulk-export corruption bug on large libraries. This piece is about a narrower, more common complaint: checklists. If you have searched something like “apple notes checklist not exporting” because a to-do list, a shopping list, or a packing list came out of Notes looking wrong, or came back into Notes looking wrong, here is what is actually going on.

The Two Things People Mean by “Not Exporting”

“My checklist isn’t exporting” usually means one of two different problems, and it is worth separating them because the cause and the fix are different.

  • The exported file looks wrong in another app. You export a note with a checklist to Markdown and open the file in a text editor, Obsidian, or another Markdown app, and the checkboxes either do not render as checkboxes or the indentation under a heading looks off.
  • The checklist breaks coming back into Notes. You export a checklist, edit the Markdown file somewhere else, and import it back into Notes, and the checkbox state or the list structure does not match what you started with.

Based on the public record, the second case is the one that is actually documented. The first case, a checkbox simply missing from the exported text itself, is not something we found a specific, corroborated report of, though the sample of reports overall is thin enough that it is worth treating this as unconfirmed rather than ruled out.

What Apple Actually Confirms Survives the Trip

Neither Apple’s own support documentation nor independent coverage of the feature spells out a complete, element-by-element list of what the Markdown export and import support. What does exist is a shorter, informal list of what reviewers have specifically confirmed converts cleanly in both directions: headings, bulleted lists, bold and italic text, and standard hyperlinks. Gadget Hacks’ walkthrough of the feature states this directly: “Common formatting generally survives the trip. Headings, bulleted lists, bold and italic text, and standard hyperlinks convert cleanly in both directions.” Checklists are not named in that sentence, and they are not named anywhere else in that coverage either, not as supported and not as broken. That absence is the first real signal that checklists sit in a different, less certain category than the basics.

Formatting elementConfirmed round-trip status
HeadingsYes, converts cleanly both ways
Bulleted lists (no checkboxes)Yes, converts cleanly both ways
Bold and italic textYes, converts cleanly both ways
Standard hyperlinksYes, converts cleanly both ways
Checklists / checkboxesNot confirmed either way, real reports of breakage on re-import
Cross-note links (>> shortcut)No, degrades to plain text on export/import
Highlight colorsNo, does not carry over the Markdown path

The same coverage does name two things that are confirmed broken: Notes’ internal cross-note links, created with the >>Note Title shortcut, degrade to plain text once exported and reimported elsewhere, and highlight colors do not survive the Markdown path at all even though they survive a simple copy and paste. Checklists are not grouped with either the confirmed-safe list or the confirmed-broken list. They are simply not addressed, which is why the clearest evidence about them comes from user reports instead of official documentation.

The Documented Report: Checkboxes and Double Indentation

The clearest account sits in a MacRumors Forums thread titled “iOS 26: Import and Export Markdown Files in Apple Notes.” On September 3, 2025, a user named novagamer asked whether checkboxes could be imported via Markdown at all, describing the feature as “sorely needed” and noting they could not get it to work. The same post described a second, more specific problem: when a checklist sat under a heading or an instructional line, like a recipe or a shopping list with a short note above the items, the imported sub-list came back double-indented rather than matching the original structure.

From the thread, Sep 3, 2025
novagamer: “Can you import checkboxes? I couldn’t get that to work via Markdown and it’s sorely needed”, describing recipes and shopping lists where a sub-list separated from the main list by a heading or instruction came back double-indented.

Another user, ignatius345, replied the same day with a working method, shown through screenshots rather than typed-out text, demonstrating a checklist that imported correctly once the Markdown was structured a specific way. The following day, novagamer confirmed it worked, calling the fix “a huge time saver” and “my favorite iOS26 feature.” That is a real, resolved exchange, not an open complaint, but it confirms two things worth knowing before you rely on a checklist export: getting checkboxes to import cleanly was not obvious to an experienced user on the first try, and indentation under a heading was the specific pattern that broke.

Is This an Export Bug or an Import Bug?

Based on everything documented, this is an import-side problem, not an export-side one. Nothing in the forum thread or the independent coverage describes a checkbox disappearing or failing to write out when you export a note from Notes to Markdown. The reported failure happens on the way back in: a Markdown file containing a checklist, whether it came from Notes originally or was written by hand, does not reliably reproduce the same checkbox state and indentation once it is imported into Notes.

Practical takeaway
If you just want to export a checklist and read it elsewhere, standard Markdown checkbox syntax is plain text and should display normally in any Markdown-aware app. The risk shows up specifically if you plan to bring that file back into Apple Notes and expect an exact match.

Why a Checklist Under a Heading Probably Breaks

Apple has not published an explanation, so this is informed reasoning rather than a confirmed mechanism. Notes’ Markdown parser has to decide, line by line, whether a dash starting a line means a plain bullet, a checklist item, or the start of a new nested level, and a heading or instructional line sitting directly above a checklist with no blank line separating them is exactly the kind of ambiguous boundary that trips up a parser like that. Standard Markdown convention treats a blank line as the signal that a new block, like a list, is starting fresh; skip that blank line and an importer has to guess whether the list continues the previous block or starts a new one, and a wrong guess shows up as the doubled indentation reported in the thread. This is a plausible explanation for why the pattern specifically involves a heading or instruction sitting right above the list, not a diagnosis Apple has confirmed.

How to Keep a Checklist Intact

  1. Use standard checklist syntax. A hyphen, a space, square brackets with either nothing or an x inside for a checked item, a space, then the item text. This is the conventional Markdown task-list format most editors and apps, including the one demonstrated in the MacRumors thread, expect.
  2. Put a blank line before a checklist that follows a heading or instruction. This is the specific pattern reported to cause doubled indentation on import, and it costs nothing to add.
  3. Test with a short file first. Before importing a long checklist-heavy note, try a short version with two or three items and confirm the checkbox state and indentation land correctly.
  4. Compare the imported note against the source file. Open the note in Notes after importing and check it against the Markdown file rather than assuming the import matched exactly, the same spot-check habit worth applying to any bulk Markdown operation in Notes right now.
  5. Consider a tool that renders the note instead of relying on text syntax if checklists are central to how you use Notes and you need a reliable one-way export. Apple Notes Exporter Pro reads the note directly and renders it, checklist included, into the output format you choose, rather than depending on Markdown checkbox text surviving a trip back into Notes.

Native Round-Trip vs a Dedicated Exporter

QuestionNative Markdown export/importApple Notes Exporter Pro
Checklist handlingNot confirmed either way, real re-import reportsRendered directly from the note
Re-import into NotesYes, this is where checklist issues are reportedNot applicable, export-only tool
Output formatsMarkdown, PDF (one at a time)PDF, Word, Markdown, HTML, Plain Text, RTF, EPUB, LaTeX, JSON, JSONL
Bulk exportYes, but flattens folder structureYes, folder structure preserved
Scheduled backupsNo, manual each timeYes, daily / weekly / monthly
CostFree, built into macOS 26 / iOS 26$14.99 one-time

Rendering the note directly is not proof any tool, including ours, is free of every possible bug. It does mean the specific failure mode described here, a checklist breaking on re-import, does not apply to an export-only tool, since there is no re-import step for it to happen in.

Already Lost Checkbox State? What to Check

If you have already exported a checklist-heavy note and re-imported it, or received one from someone else, open it in Notes and compare the checkbox state and indentation against whatever source you have, a previous export, a screenshot, or your memory of the list. If a sub-list under a heading is indented differently than it should be, that matches the reported pattern and is worth manually correcting rather than assuming it will fix itself on a re-export. Because the underlying issue, based on everything documented, sits in the import step rather than in Notes’ own storage of the note, fixing the checklist once inside Notes should hold going forward until the next Markdown round trip.

Sources

Frequently Asked Questions

Why is my Apple Notes checklist not exporting correctly to Markdown?
There is no widely confirmed bug where a checklist simply fails to write to the exported file. What is documented is narrower: checklists are not on the short list of formatting Apple and independent write-ups of the feature confirm round-trips cleanly, which is headings, bulleted lists, bold and italic text, and standard hyperlinks. Real users report the checkbox state or list indentation breaking specifically when a Markdown checklist is brought back into Notes, not the checkbox text vanishing from the export itself.
Does Apple say checklists are supported in its Markdown export?
Not explicitly, in either direction. Apple’s own support documentation describes the export and import features in general terms without listing which formatting elements are covered. Independent coverage of the feature, including AppleInsider and Gadget Hacks, lists what is confirmed to convert cleanly, headings, bulleted lists, bold and italic text, and hyperlinks, and checklists are conspicuously absent from that list rather than being called out as broken.
What actually goes wrong with checklists?
A dated MacRumors Forums exchange from September 2025 documents the clearest case: a user described being unable to get checkboxes to import cleanly via Markdown, and separately described a sub-list sitting under a heading or an instructional line coming back double-indented. A working method was eventually shared and confirmed to fix the import, but the exchange shows checklist handling is not the same solid, boring feature that headings and bold text already are.
Is this an export problem or an import problem?
Based on the public record, the reported failure shows up specifically on the way back in, when a Markdown file containing a checklist is imported into Notes, not on the initial export out of Notes. If you export a checklist and just want to read it in another Markdown app or a text editor, the underlying `- [ ]` / `- [x]` syntax is standard and should display normally. The risk is re-importing that file into Notes and expecting the checkboxes and indentation to land exactly where they started.
How do I stop my checklist from breaking when I re-import it?
Keep checklist items in standard Markdown task syntax, a hyphen, a space, brackets with either nothing or an x inside, a space, then the text, and avoid placing a checklist directly under a heading or instructional line without a blank line separating them, since that is the specific pattern reported to cause doubled indentation. Then open the note after importing and compare it against the source file before you delete anything.
Does Apple Notes Exporter Pro handle checklists differently?
It renders each note, checklists included, directly from your Notes library into the output format you choose, rather than depending on Markdown checkbox text surviving a round trip back into Notes. It is also export-only, so the specific failure mode reported here, breakage on re-import, does not apply to it since there is no re-import step.

The Bottom Line

Checklists are not confirmed broken in Apple Notes’ native Markdown export, but they are not confirmed solid either, which is exactly why they cause more confusion than the formatting Apple and reviewers have actually vetted. The one specific, documented failure pattern is checkbox state and indentation breaking when a Markdown checklist, especially one sitting under a heading, is imported back into Notes. Use standard checklist syntax, separate a checklist from a heading with a blank line, and check the result after importing rather than assuming it matched. That habit costs a minute and protects a list you would otherwise have to rebuild by hand.


Keep reading: see what else macOS 26’s native Markdown export gets right and wrong, check whether a large bulk export could be hitting a more serious corruption bug, or browse every Apple Notes export and backup guide.

Want Checklists Preserved Without a Round Trip?

Apple Notes Exporter Pro renders each note, checklists included, straight from your Notes library into PDF, Word, Markdown, and seven other formats, with no re-import step for checkbox state to break in.

Explore Apple Notes Exporter ProRead More Guides