Free MD test files and sample generator
Lightweight markup for formatted text using plain characters. The standard for READMEs, docs and notes.
What is a .md file?
MD: Markdown. Markdown is the writing format of READMEs, docs sites, wikis and issue trackers. Because rendering differs between implementations, a sample file is useful for checking how your renderer handles tables, code blocks and long documents.
Why generate a test MD file?
- Test a Markdown renderer or docs pipeline against tables, headings and code blocks.
- Check performance and pagination when rendering a long document.
- Verify sanitization of a document containing unexpected markup.
What you can put inside a .md file
You get 4 content options for MD, so the file holds something meaningful rather than random padding: Article (headings + paragraphs), Table, List, Code blocks. Pick several and they are merged into one file, with a section, sheet, slide or folder for each.
How a .md file is identified
A .md file has no signature at the start. A text format has no identifying leading bytes, so the extension and the reported media type are the only claims about it until a parser actually reads it, which is why validating uploads by extension alone is unsafe.
How the size lands on the exact byte
Rows and lines are generated to fill the target, and the last line is padded to land on the exact byte.
Negative testing with broken MD files
- Invalid. Identifiable, but wrong inside, so it fails during parsing.
- Corrupted. The leading bytes are destroyed. Same length as the valid file.
- Incomplete. Truncated part-way, so it is genuinely shorter.
- Empty. Chosen under Content rather than File Condition: valid structure, no data.
Which failure to reach for, and what to assert for each, is covered in how to make a corrupted file for testing. For upload limits and type checks see testing file upload validation, and for this format's encodings, UTF-16 and BOM test files.
Sample MD content
# Test Report - **Status:** passing - Coverage: `92%` > All checks green.
This shows the shape of the file. Your download is generated fresh at the size you choose, so the values will differ.
How to open and verify the file
Preview in any editor with Markdown support, or render with `pandoc file.md -o out.html`.
Media type text/markdown · extension .md · category Doc & TXT
Generate a .md file → · questions about sizes, privacy or cost are answered on the site FAQ.
Frequently asked questions about MD files
What identifies a .md file?
Nothing at the start of the file does. A text format has no identifying leading bytes, so the extension and the reported media type are the only claims about it until a parser actually reads it, which is why validating uploads by extension alone is unsafe.
How can a .md file be an exact number of bytes?
Rows and lines are generated to fill the target, and the last line is padded to land on the exact byte.
What can go inside the MD file?
There are 4 content options for .md: Article (headings + paragraphs), Table, List, Code blocks. Choose more than one and they are combined into a single file, a section, sheet, slide or folder per option, rather than downloaded separately.
Can I download several broken MD files at once?
Yes, select more than one File Condition and you get one ZIP containing a .md per condition, each named after its condition.
Can the MD file use UTF-16 or a byte-order mark?
Yes. .md is a text format, so it can be generated as UTF-8, UTF-8 with a byte-order mark, UTF-16 LE or UTF-16 BE. The body is shortened before re-encoding so the finished file still lands on the exact size you asked for. Note that a UTF-16 file always has an even byte count.
How do I open or verify the MD file?
Preview in any editor with Markdown support, or render with pandoc file.md -o out.html.