ImgHeal

Export Tropy Photo Notes to Markdown Without Losing Their Meaning

By ImgHeal · Updated

Exporting notes to Markdown can make Tropy research easier to read outside the project. Preserve the object ID, source reference, and uncertainty markers with each note. Plain text portability helps only if the reader can still distinguish a transcription from your interpretation of it.

Explore this topic: Organize a photo archive

AI-generated editorial illustration

Prepare a note that explains itself

Begin with the physical object ID and the photo or selection that the note concerns. Separate literal source wording from commentary using clear headings. Keep questionable letters marked consistently and explain the convention once in the handoff. Avoid relying on a pane's position or a highlighted selection as the only sign of context, because that visual arrangement may not accompany the text. Make a representative sample containing a list, a link, and an uncertain reading before exporting all notes.

Check the chosen export format

Tropy documents a preference for exporting notes as HTML or Markdown. Choose the format required by the recipient's workflow and inspect a sample output in a plain text editor as well as its intended reader. Verify that headings, line breaks, punctuation, and links still convey the distinction between evidence and commentary. A readable rendered preview can hide raw syntax that becomes confusing in another application. Keep the original project note while resolving the export rather than rewriting the research record to compensate for a display issue.

Rebuild the route back to each photograph

Try locating the source image using only the exported note and its supplied file references. If that requires remembering which project pane was active, add a clearer object-and-view reference. Check links for access restrictions and replace private machine paths with documented package-relative references where appropriate. Keep exported notes versioned so later corrections can be tracked. When a restored viewing photo accompanies the research, identify it separately and retain the unedited inscription capture supporting any transcript. ImgHeal's output may be useful for family viewing without becoming the authority for a disputed letter or date.

Check this workflow

  • State the object and view at the top of the note.
  • Inspect raw text as well as a rendered preview.
  • Find the source using only the exported handoff.

Sources and further reading

  • Tropy: ExportDistinguishes metadata-and-notes JSON-LD export from transferring image files.
  • Tropy: PreferencesDescribes project path relationships, default templates, duplicate handling, and note export formats.

Questions about this restoration task

Should I remove uncertainty brackets to make exported notes cleaner?

No. Preserve the convention and explain it. A tidy export should not turn a doubtful reading into a confident historical statement.

Continue with a related guide

Try a restoration on a copy of your photo

Keep the original scan. Upload a separate digital copy, review ImgHeal’s generated result, and decide whether it suits your needs.

Open ImgHeal