YAML front matter Leave feedback
On this page
Enable include_front_matter to extract document metadata into a YAML block at the beginning of the Markdown output. This is commonly used by static site generators like Jekyll, Hugo, and Docusaurus.
from groupdocs.markdown import MarkdownConverter, ConvertOptions
def front_matter_example():
"""Convert a document to Markdown with YAML front matter extracted from metadata."""
# Step 1: Enable front matter generation in conversion options
options = ConvertOptions()
options.include_front_matter = True
# Step 2: Convert the document and save it to a Markdown file
MarkdownConverter.to_file("business-plan.docx", "front-matter-example.md", convert_options=options)
# Output:
# ---
# title: "Q3 Report"
# author: "Jane Doe"
# format: Docx
# pages: 12
# ---
#
# # Q3 Report
# ...
if __name__ == "__main__":
front_matter_example()
business-plan.docx is sample file used in this example. Click here to download it.
---
title: "Meridian Outdoor Co. — Business Plan"
author: "Meridian Outdoor Co."
format: Docx
pages: 5
---
:
"""Convert a document with both YAML front matter and heading level offset."""
# Step 1: Configure options with front matter and heading offset
options = ConvertOptions()
options.include_front_matter = True # add YAML metadata block
options.heading_level_offset = 1 # shift headings down one level
# Step 2: Convert and save to a file using keyword argument for options
MarkdownConverter.to_file("annual-report.docx", "front-matter-combined.md", convert_options=options)
if __name__ == "__main__":
front_matter_combined()
annual-report.docx is sample file used in this example. Click here to download it.
---
title: "Meridian Outdoor Co. — Annual Report 2025"
author: "Elena Márquez, CFO"
format: Docx
pages: 6
---
![](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAlgAAAC0CAYAAABIf1IMAAAABHNCSVQICAgIfAhkiAAADcJJREFUeJzt3VFo3VWeB/BfF2EfdJraSWKkpovabiokaRZcfWiM4jCS0mELjvgwzlZt16fdlUFpKbLCgDKELQ7Oum+yNdYdH4StCLMkdBexSfow7sC0SUA7TZVJW0zbWI1OF/ap+xD+/97k/u/Nze1JbJLPBwo9/3vu/Z1/L5Qv55x7/uumJkauBQAAyfzZdz0AAIDVRsACAEhMwAIASEzAAgBI7Jaii//67/8dZ89dSlbkH576Qdy7+Y4F+6Wqq5566qmnnnrqqbdc9YoUBqyJyYsxevrcDQ2q1Ld
[TRUNCATED]
Only non-empty fields are included:
| Field | Source | Example |
|---|---|---|
title | BuiltInDocumentProperties.Title | "Q3 Report" |
author | BuiltInDocumentProperties.Author | "Jane Doe" |
format | Detected file format | Docx |
pages | Page or worksheet count | 12 |
Was this page helpful?
Any additional feedback you'd like to share with us?
Please tell us how we can improve this page.
Thank you for your feedback!
We value your opinion. Your feedback will help us improve our documentation.
