Create Markdown document
create_markdown_fileRead-onlyIdempotent
Makes one standalone Markdown (.md) file with YAML front matter. Use when the user wants notes, documentation or an article as a file. Needs content; title, frontmatter and filename are optional. Returns the full file text with a suggested file name, word count, line count and size in bytes. Nothing is stored. Use create_obsidian_note instead when the user wants the note opened in Obsidian.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| title | No | Optional document title (included in YAML frontmatter). | |
| content | Yes | Markdown document text (at most 100,000 characters), such as "## What went well\n- Shipped on time". | |
| filename | No | Optional .md filename (defaults to sanitized title or document.md). | |
| frontmatter | No | Optional extra YAML front matter as key-value pairs. Values can be text, numbers, true or false, or lists, such as {"status": "draft", "version": 1}. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bytes | Yes | File size in UTF-8 bytes. | |
| notes | Yes | Short notes to pass on to the user. | |
| status | Yes | Always ok when the file was made. Bad input returns an error instead. | |
| filename | Yes | Sanitized filename for saving as a .md file. | |
| line_count | Yes | Total line count of the document. | |
| word_count | Yes | Total word count of the document. | |
| markdown_text | Yes | Complete formatted Markdown document with frontmatter. |