Automatically parse Markdown files and extract tables into Flatfile Sheets
.md
) uploaded to Flatfile. Its primary purpose is to find and extract any tables present in the markdown content. For each table it discovers, the plugin creates a new Sheet within the Flatfile Space. The table’s header row is used to define the fields (columns) of the Sheet, and the subsequent rows are converted into records. This is useful for importing data that is documented or stored in Markdown files, such as in project readmes, wikis, or technical documentation.
number
Infinity
'strict' | 'lenient'
'lenient'
'strict'
: The plugin will throw an error and stop processing if it encounters a malformed table (e.g., a data row with a different number of columns than the header)'lenient'
: The plugin will log a warning to the console, skip the problematic table, and continue processing the rest of the fileboolean
false
options
(optional): Configuration settings objectExtractor
instance that can be passed to listener.use()
Example:
WorkbookCapture
object.
Parameters:
buffer
: A Node.js Buffer containing the UTF-8 encoded content of a markdown fileoptions
: Configuration settings objectWorkbookCapture
object, which is a map of sheet names to sheet data
Example:
errorHandling
option affects behavior when parsing a malformed table:
maxTables: Infinity
).md
extensionTable_1
, Table_2
, etc.)debug: true
to enable detailed logging for diagnosing parsing issues