Lemora › Guides

Turn a CSV into a Markdown table for a README on Mac

A small CSV table can make useful documentation, but manually adding pipes and header separators is tedious. Lemora's Markdown Table action writes a .md file from a spreadsheet or CSV. Paste the result into your README, then preview it where the document will be published.

Prepare the table, convert it, then preview it

  1. Inspect the CSV and make sure its first row contains the column headings you want readers to see. Remove unrelated rows in a separate prepared copy if needed.
  2. With Lemora running, select the CSV in Finder and press Shift-Command-E. Choose MD (Markdown Table) on the Convert page.
  3. Open the saved .md file in a text editor and copy the table into your README or issue draft.
  4. Leave a blank line before the table and preview it in the destination renderer. Check the headings, column count and any cells containing punctuation or line breaks.
  5. Add a short explanation of what the table shows and where its values came from before publishing.

Results are saved beside the originals when folder access is available, or in Downloads/Lemora otherwise. Source files are never overwritten.

Where to find these actions

What you get

A Markdown file containing a table

The first row becomes the header. Pipe characters inside cells are escaped, and cell line breaks are represented with HTML break tags.

Works with: CSV, TSV and supported spreadsheet files with a meaningful first row.

Make the first row a real header

The conversion treats the first row as the table's headings. A title or introductory sentence at the top of the CSV will therefore become a header instead of a caption. Prepare a copy with the actual field names first. Choose names that explain the values without requiring a reader to inspect the original spreadsheet.

Check special characters in the rendered document

Markdown uses pipe characters to separate columns. Lemora escapes pipes inside cell values so they can remain cell content, and writes line breaks as HTML break tags. Rendering can vary between documentation tools. Inspect the actual destination rather than judging only the plain-text source.

Keep README tables small enough to read

A wide spreadsheet can become an awkward table on a narrow screen. Select the columns and rows that help explain the project, and link to a larger dataset when the full export is more than a reader needs. The conversion does not choose a useful subset or summarize long cells for you.

Workbook structure becomes text structure

For multiple worksheets, the Markdown output separates tables with sheet-name headings. It does not preserve spreadsheet styling, charts or interactive filters. Review each table before pasting the whole file into a document; some worksheets may be internal working material rather than useful documentation.

Treat the Markdown table as a published snapshot

Changing the source CSV later does not update a README you have already edited. Keep track of the source and regenerate the table when the values change. Check the resulting diff before publishing so that an update does not accidentally add private or unrelated records.

GitHub: organizing information with tables

Questions

Does this copy the Markdown directly to the clipboard?

This action writes a .md file. Open it to copy the table into your document.

Will every Markdown editor display the table?

Table support and HTML handling vary. Preview the file in your intended destination.

Does it preserve spreadsheet formatting?

No. It creates text tables rather than preserving cell colors, formulas as working calculations or workbook layout.

Try this workflow on your Mac

Download Lemora on the Mac App Store Free to try: every feature for your first 25 actions. macOS 15 or later.

More guides