[{"data":1,"prerenderedAt":72},["Reactive",2],{"blog-post-markdown-frontmatter-metadata-complete-guide":3},{"slug":4,"title":5,"description":6,"excerpt":7,"date":8,"category":9,"author":10,"keywords":11,"readingMinutes":12,"html":13,"headings":14,"tools":46,"related":47},"markdown-frontmatter-metadata-complete-guide","Markdown Front Matter and Metadata: Complete Guide for Documentation and Content Management","Master Markdown front matter and metadata for static site generators, Jekyll, Hugo, and content management systems. Learn YAML, TOML, and JSON formats with practical examples.","Markdown front matter is the metadata section at the beginning of Markdown files that provides structured information about your content. Used extensively in static site generators like Jekyll,…","2025-10-30","Tutorial","Matthew Rathbone","markdown front matter, markdown metadata, yaml frontmatter, jekyll front matter, hugo front matter, markdown headers, static site generator metadata",8,"\u003Cp>Markdown front matter is the metadata section at the beginning of Markdown files that provides structured information about your content. Used extensively in static site generators like Jekyll, Hugo, and Gatsby, front matter enables powerful content management, automated organization, and dynamic website generation from simple Markdown files.\u003C/p>\n\u003Cp>This comprehensive guide covers everything you need to know about Markdown front matter, from basic syntax to advanced use cases, helping you leverage metadata to build sophisticated documentation and content management systems.\u003C/p>\n\u003Ch2 id=\"what-is-markdown-front-matter\">What is Markdown Front Matter?\u003C/h2>\n\u003Cp>Front matter is a block of metadata placed at the very beginning of a Markdown file, enclosed between triple dashes (\u003Ccode>---\u003C/code>). This metadata is invisible when the Markdown is rendered as HTML but is processed by static site generators and other tools to enhance content management and site functionality.\u003C/p>\n\u003Ch3 id=\"basic-front-matter-structure\">Basic Front Matter Structure\u003C/h3>\n\u003Cpre>\u003Ccode class=\"hljs language-yaml\">\u003Cspan class=\"hljs-meta\">---\u003C/span>\n\u003Cspan class=\"hljs-attr\">title:\u003C/span> \u003Cspan class=\"hljs-string\">"Your Document Title"\u003C/span>\n\u003Cspan class=\"hljs-attr\">date:\u003C/span> \u003Cspan class=\"hljs-number\">2025-10-30\u003C/span>\n\u003Cspan class=\"hljs-attr\">author:\u003C/span> \u003Cspan class=\"hljs-string\">"Your Name"\u003C/span>\n\u003Cspan class=\"hljs-attr\">tags:\u003C/span> [\u003Cspan class=\"hljs-string\">markdown\u003C/span>, \u003Cspan class=\"hljs-string\">tutorial\u003C/span>]\n\u003Cspan class=\"hljs-meta\">---\n\u003C/span>\n\u003Cspan class=\"hljs-comment\"># Your Markdown Content Starts Here\u003C/span>\n\n\u003Cspan class=\"hljs-string\">This\u003C/span> \u003Cspan class=\"hljs-string\">is\u003C/span> \u003Cspan class=\"hljs-string\">your\u003C/span> \u003Cspan class=\"hljs-string\">regular\u003C/span> \u003Cspan class=\"hljs-string\">Markdown\u003C/span> \u003Cspan class=\"hljs-string\">content...\u003C/span>\n\u003C/code>\u003C/pre>\u003Cp>The front matter section uses structured data formats, most commonly YAML, but can also use TOML or JSON depending on your platform's requirements.\u003C/p>\n\u003Ch2 id=\"front-matter-formats\">Front Matter Formats\u003C/h2>\n\u003Ch3 id=\"yaml-front-matter-most-common\">YAML Front Matter (Most Common)\u003C/h3>\n\u003Cp>YAML is the most widely supported format for front matter due to its readability and flexibility:\u003C/p>\n\u003Cpre>\u003Ccode class=\"hljs language-yaml\">\u003Cspan class=\"hljs-meta\">---\u003C/span>\n\u003Cspan class=\"hljs-attr\">title:\u003C/span> \u003Cspan class=\"hljs-string\">"Complete Guide to Markdown Tables"\u003C/span>\n\u003Cspan class=\"hljs-attr\">description:\u003C/span> \u003Cspan class=\"hljs-string\">"Learn how to create and style tables in Markdown"\u003C/span>\n\u003Cspan class=\"hljs-attr\">author:\u003C/span> \u003Cspan class=\"hljs-string\">"Matthew Rathbone"\u003C/span>\n\u003Cspan class=\"hljs-attr\">date:\u003C/span> \u003Cspan class=\"hljs-number\">2025-10-30\u003C/span>\n\u003Cspan class=\"hljs-attr\">published:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n\u003Cspan class=\"hljs-attr\">categories:\u003C/span> \n  \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">tutorial\u003C/span>\n  \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">markdown\u003C/span>\n\u003Cspan class=\"hljs-attr\">tags:\u003C/span> [\u003Cspan class=\"hljs-string\">tables\u003C/span>, \u003Cspan class=\"hljs-string\">formatting\u003C/span>, \u003Cspan class=\"hljs-string\">guide\u003C/span>]\n\u003Cspan class=\"hljs-attr\">excerpt:\u003C/span> \u003Cspan class=\"hljs-string\">"Tables are a powerful feature in Markdown..."\u003C/span>\n\u003Cspan class=\"hljs-attr\">featured:\u003C/span> \u003Cspan class=\"hljs-literal\">false\u003C/span>\n\u003Cspan class=\"hljs-attr\">comments:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n\u003Cspan class=\"hljs-meta\">---\u003C/span>\n\u003C/code>\u003C/pre>\u003Ch3 id=\"toml-front-matter\">TOML Front Matter\u003C/h3>\n\u003Cp>Some static site generators like Hugo support TOML format:\u003C/p>\n\u003Cpre>\u003Ccode class=\"hljs language-toml\">+++\n\u003Cspan class=\"hljs-attr\">title\u003C/span> = \u003Cspan class=\"hljs-string\">"Complete Guide to Markdown Tables"\u003C/span>\n\u003Cspan class=\"hljs-attr\">description\u003C/span> = \u003Cspan class=\"hljs-string\">"Learn how to create and style tables in Markdown"\u003C/span>\n\u003Cspan class=\"hljs-attr\">author\u003C/span> = \u003Cspan class=\"hljs-string\">"Matthew Rathbone"\u003C/span>\n\u003Cspan class=\"hljs-attr\">date\u003C/span> = \u003Cspan class=\"hljs-number\">2025\u003C/span>-\u003Cspan class=\"hljs-number\">10\u003C/span>-\u003Cspan class=\"hljs-number\">30\u003C/span>T10:\u003Cspan class=\"hljs-number\">00\u003C/span>:\u003Cspan class=\"hljs-number\">00\u003C/span>Z\n\u003Cspan class=\"hljs-attr\">published\u003C/span> = \u003Cspan class=\"hljs-literal\">true\u003C/span>\n\u003Cspan class=\"hljs-attr\">categories\u003C/span> = [\u003Cspan class=\"hljs-string\">"tutorial"\u003C/span>, \u003Cspan class=\"hljs-string\">"markdown"\u003C/span>]\n\u003Cspan class=\"hljs-attr\">tags\u003C/span> = [\u003Cspan class=\"hljs-string\">"tables"\u003C/span>, \u003Cspan class=\"hljs-string\">"formatting"\u003C/span>, \u003Cspan class=\"hljs-string\">"guide"\u003C/span>]\n\u003Cspan class=\"hljs-attr\">featured\u003C/span> = \u003Cspan class=\"hljs-literal\">false\u003C/span>\n+++\n\u003C/code>\u003C/pre>\u003Ch3 id=\"json-front-matter\">JSON Front Matter\u003C/h3>\n\u003Cp>JSON format is less common but supported by some platforms:\u003C/p>\n\u003Cpre>\u003Ccode class=\"hljs language-json\">\u003Cspan class=\"hljs-punctuation\">{\u003C/span>\n  \u003Cspan class=\"hljs-attr\">"title"\u003C/span>\u003Cspan class=\"hljs-punctuation\">:\u003C/span> \u003Cspan class=\"hljs-string\">"Complete Guide to Markdown Tables"\u003C/span>\u003Cspan class=\"hljs-punctuation\">,\u003C/span>\n  \u003Cspan class=\"hljs-attr\">"description"\u003C/span>\u003Cspan class=\"hljs-punctuation\">:\u003C/span> \u003Cspan class=\"hljs-string\">"Learn how to create and style tables in Markdown"\u003C/span>\u003Cspan class=\"hljs-punctuation\">,\u003C/span>\n  \u003Cspan class=\"hljs-attr\">"author"\u003C/span>\u003Cspan class=\"hljs-punctuation\">:\u003C/span> \u003Cspan class=\"hljs-string\">"Matthew Rathbone"\u003C/span>\u003Cspan class=\"hljs-punctuation\">,\u003C/span>\n  \u003Cspan class=\"hljs-attr\">"date"\u003C/span>\u003Cspan class=\"hljs-punctuation\">:\u003C/span> \u003Cspan class=\"hljs-string\">"2025-10-30"\u003C/span>\u003Cspan class=\"hljs-punctuation\">,\u003C/span>\n  \u003Cspan class=\"hljs-attr\">"published"\u003C/span>\u003Cspan class=\"hljs-punctuation\">:\u003C/span> \u003Cspan class=\"hljs-literal\">\u003Cspan class=\"hljs-keyword\">true\u003C/span>\u003C/span>\u003Cspan class=\"hljs-punctuation\">,\u003C/span>\n  \u003Cspan class=\"hljs-attr\">"categories"\u003C/span>\u003Cspan class=\"hljs-punctuation\">:\u003C/span> \u003Cspan class=\"hljs-punctuation\">[\u003C/span>\u003Cspan class=\"hljs-string\">"tutorial"\u003C/span>\u003Cspan class=\"hljs-punctuation\">,\u003C/span> \u003Cspan class=\"hljs-string\">"markdown"\u003C/span>\u003Cspan class=\"hljs-punctuation\">]\u003C/span>\u003Cspan class=\"hljs-punctuation\">,\u003C/span>\n  \u003Cspan class=\"hljs-attr\">"tags"\u003C/span>\u003Cspan class=\"hljs-punctuation\">:\u003C/span> \u003Cspan class=\"hljs-punctuation\">[\u003C/span>\u003Cspan class=\"hljs-string\">"tables"\u003C/span>\u003Cspan class=\"hljs-punctuation\">,\u003C/span> \u003Cspan class=\"hljs-string\">"formatting"\u003C/span>\u003Cspan class=\"hljs-punctuation\">,\u003C/span> \u003Cspan class=\"hljs-string\">"guide"\u003C/span>\u003Cspan class=\"hljs-punctuation\">]\u003C/span>\n\u003Cspan class=\"hljs-punctuation\">}\u003C/span>\n\u003C/code>\u003C/pre>\u003Ch2 id=\"essential-front-matter-fields\">Essential Front Matter Fields\u003C/h2>\n\u003Ch3 id=\"core-content-fields\">Core Content Fields\u003C/h3>\n\u003Cp>\u003Cstrong>Title\u003C/strong>: The document title displayed in headers and metadata\u003C/p>\n\u003Cpre>\u003Ccode class=\"hljs language-yaml\">\u003Cspan class=\"hljs-attr\">title:\u003C/span> \u003Cspan class=\"hljs-string\">"Your Document Title"\u003C/span>\n\u003Cspan class=\"hljs-comment\"># Can include HTML entities and special characters\u003C/span>\n\u003Cspan class=\"hljs-attr\">title:\u003C/span> \u003Cspan class=\"hljs-string\">"How to Use <code> Tags in Markdown"\u003C/span>\n\u003C/code>\u003C/pre>\u003Cp>\u003Cstrong>Description\u003C/strong>: SEO description and content summary\u003C/p>\n\u003Cpre>\u003Ccode class=\"hljs language-yaml\">\u003Cspan class=\"hljs-attr\">description:\u003C/span> \u003Cspan class=\"hljs-string\">"A comprehensive guide to using Markdown effectively"\u003C/span>\n\u003Cspan class=\"hljs-comment\"># Keep descriptions between 150-160 characters for optimal SEO\u003C/span>\n\u003Cspan class=\"hljs-attr\">description:\u003C/span> \u003Cspan class=\"hljs-string\">"Learn advanced Markdown techniques including tables, code blocks, and formatting options for professional documentation."\u003C/span>\n\u003C/code>\u003C/pre>\u003Cp>\u003Cstrong>Date\u003C/strong>: Publication or creation date\u003C/p>\n\u003Cpre>\u003Ccode class=\"hljs language-yaml\">\u003Cspan class=\"hljs-attr\">date:\u003C/span> \u003Cspan class=\"hljs-number\">2025-10-30\u003C/span>\n\u003Cspan class=\"hljs-comment\"># ISO format with time\u003C/span>\n\u003Cspan class=\"hljs-attr\">date:\u003C/span> \u003Cspan class=\"hljs-number\">2025-10-30T14:30:00Z\u003C/span>\n\u003Cspan class=\"hljs-comment\"># Date with timezone\u003C/span>\n\u003Cspan class=\"hljs-attr\">date:\u003C/span> \u003Cspan class=\"hljs-number\">2025-10-30 14:30:00\u003C/span> \u003Cspan class=\"hljs-number\">-0500\u003C/span>\n\u003C/code>\u003C/pre>\u003Ch3 id=\"author-and-attribution\">Author and Attribution\u003C/h3>\n\u003Cp>\u003Cstrong>Author Information\u003C/strong>:\u003C/p>\n\u003Cpre>\u003Ccode class=\"hljs language-yaml\">\u003Cspan class=\"hljs-attr\">author:\u003C/span> \u003Cspan class=\"hljs-string\">"Matthew Rathbone"\u003C/span>\n\u003Cspan class=\"hljs-comment\"># Or structured author data\u003C/span>\n\u003Cspan class=\"hljs-attr\">author:\u003C/span>\n  \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">"Matthew Rathbone"\u003C/span>\n  \u003Cspan class=\"hljs-attr\">email:\u003C/span> \u003Cspan class=\"hljs-string\">"matthew@example.com"\u003C/span>\n  \u003Cspan class=\"hljs-attr\">url:\u003C/span> \u003Cspan class=\"hljs-string\">"https://matthewrathbone.com"\u003C/span>\n  \u003Cspan class=\"hljs-attr\">avatar:\u003C/span> \u003Cspan class=\"hljs-string\">"/images/author-avatar.jpg"\u003C/span>\n\u003C/code>\u003C/pre>\u003Cp>\u003Cstrong>Multiple Authors\u003C/strong>:\u003C/p>\n\u003Cpre>\u003Ccode class=\"hljs language-yaml\">\u003Cspan class=\"hljs-attr\">authors:\u003C/span>\n  \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">"Matthew Rathbone"\u003C/span>\n    \u003Cspan class=\"hljs-attr\">role:\u003C/span> \u003Cspan class=\"hljs-string\">"Technical Writer"\u003C/span>\n  \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">"Jane Smith"\u003C/span>\n    \u003Cspan class=\"hljs-attr\">role:\u003C/span> \u003Cspan class=\"hljs-string\">"Developer"\u003C/span>\n\u003C/code>\u003C/pre>\u003Ch3 id=\"categorization-and-organization\">Categorization and Organization\u003C/h3>\n\u003Cp>\u003Cstrong>Categories\u003C/strong>: Hierarchical content organization\u003C/p>\n\u003Cpre>\u003Ccode class=\"hljs language-yaml\">\u003Cspan class=\"hljs-attr\">category:\u003C/span> \u003Cspan class=\"hljs-string\">"Tutorial"\u003C/span>\n\u003Cspan class=\"hljs-comment\"># Or multiple categories\u003C/span>\n\u003Cspan class=\"hljs-attr\">categories:\u003C/span> \n  \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">"Tutorials"\u003C/span>\n  \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">"Markdown"\u003C/span>\n  \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">"Documentation"\u003C/span>\n\u003C/code>\u003C/pre>\u003Cp>\u003Cstrong>Tags\u003C/strong>: Flexible content labeling\u003C/p>\n\u003Cpre>\u003Ccode class=\"hljs language-yaml\">\u003Cspan class=\"hljs-attr\">tags:\u003C/span> [\u003Cspan class=\"hljs-string\">markdown\u003C/span>, \u003Cspan class=\"hljs-string\">tutorial\u003C/span>, \u003Cspan class=\"hljs-string\">beginner\u003C/span>]\n\u003Cspan class=\"hljs-comment\"># Or array format\u003C/span>\n\u003Cspan class=\"hljs-attr\">tags:\u003C/span>\n  \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">markdown\u003C/span>\n  \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">tutorial\u003C/span>\n  \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">beginner\u003C/span>\n  \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">documentation\u003C/span>\n\u003C/code>\u003C/pre>\u003Cp>\u003Cstrong>Keywords\u003C/strong>: SEO and search optimization\u003C/p>\n\u003Cpre>\u003Ccode class=\"hljs language-yaml\">\u003Cspan class=\"hljs-attr\">keywords:\u003C/span> \u003Cspan class=\"hljs-string\">"markdown tutorial, front matter, static site generator, jekyll"\u003C/span>\n\u003Cspan class=\"hljs-comment\"># Or array format\u003C/span>\n\u003Cspan class=\"hljs-attr\">keywords:\u003C/span> \n  \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">markdown\u003C/span> \u003Cspan class=\"hljs-string\">tutorial\u003C/span>\n  \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">front\u003C/span> \u003Cspan class=\"hljs-string\">matter\u003C/span>\n  \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">static\u003C/span> \u003Cspan class=\"hljs-string\">site\u003C/span> \u003Cspan class=\"hljs-string\">generator\u003C/span>\n  \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">jekyll\u003C/span>\n\u003C/code>\u003C/pre>\u003Ch2 id=\"platform-specific-front-matter\">Platform-Specific Front Matter\u003C/h2>\n\u003Ch3 id=\"jekyll-front-matter\">Jekyll Front Matter\u003C/h3>\n\u003Cp>Jekyll uses YAML front matter extensively for site generation:\u003C/p>\n\u003Cpre>\u003Ccode class=\"hljs language-yaml\">\u003Cspan class=\"hljs-meta\">---\u003C/span>\n\u003Cspan class=\"hljs-attr\">layout:\u003C/span> \u003Cspan class=\"hljs-string\">post\u003C/span>\n\u003Cspan class=\"hljs-attr\">title:\u003C/span> \u003Cspan class=\"hljs-string\">"Your Post Title"\u003C/span>\n\u003Cspan class=\"hljs-attr\">date:\u003C/span> \u003Cspan class=\"hljs-number\">2025-10-30 14:30:00\u003C/span> \u003Cspan class=\"hljs-number\">-0500\u003C/span>\n\u003Cspan class=\"hljs-attr\">categories:\u003C/span> [\u003Cspan class=\"hljs-string\">blog\u003C/span>, \u003Cspan class=\"hljs-string\">tutorial\u003C/span>]\n\u003Cspan class=\"hljs-attr\">tags:\u003C/span> [\u003Cspan class=\"hljs-string\">markdown\u003C/span>, \u003Cspan class=\"hljs-string\">jekyll\u003C/span>]\n\u003Cspan class=\"hljs-attr\">permalink:\u003C/span> \u003Cspan class=\"hljs-string\">/custom-url-structure/\u003C/span>\n\u003Cspan class=\"hljs-attr\">excerpt_separator:\u003C/span> \u003Cspan class=\"hljs-string\"><!--more-->\u003C/span>\n\u003Cspan class=\"hljs-attr\">author:\u003C/span> \u003Cspan class=\"hljs-string\">matthew\u003C/span>\n\u003Cspan class=\"hljs-attr\">published:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n\u003Cspan class=\"hljs-attr\">sitemap:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n\u003Cspan class=\"hljs-attr\">comments:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n\u003Cspan class=\"hljs-meta\">---\u003C/span>\n\u003C/code>\u003C/pre>\u003Cp>\u003Cstrong>Jekyll-Specific Fields\u003C/strong>:\u003C/p>\n\u003Cul>\n\u003Cli>\u003Ccode>layout\u003C/code>: Template to use for rendering\u003C/li>\n\u003Cli>\u003Ccode>permalink\u003C/code>: Custom URL structure\u003C/li>\n\u003Cli>\u003Ccode>excerpt_separator\u003C/code>: Define where post excerpts end\u003C/li>\n\u003Cli>\u003Ccode>sitemap\u003C/code>: Include in XML sitemap generation\u003C/li>\n\u003C/ul>\n\u003Ch3 id=\"hugo-front-matter\">Hugo Front Matter\u003C/h3>\n\u003Cp>Hugo supports multiple front matter formats with extensive customization:\u003C/p>\n\u003Cpre>\u003Ccode class=\"hljs language-yaml\">\u003Cspan class=\"hljs-meta\">---\u003C/span>\n\u003Cspan class=\"hljs-attr\">title:\u003C/span> \u003Cspan class=\"hljs-string\">"Your Post Title"\u003C/span>\n\u003Cspan class=\"hljs-attr\">date:\u003C/span> \u003Cspan class=\"hljs-number\">2025-10-30T14:30:00Z\u003C/span>\n\u003Cspan class=\"hljs-attr\">lastmod:\u003C/span> \u003Cspan class=\"hljs-number\">2025-10-30T15:00:00Z\u003C/span>\n\u003Cspan class=\"hljs-attr\">draft:\u003C/span> \u003Cspan class=\"hljs-literal\">false\u003C/span>\n\u003Cspan class=\"hljs-attr\">weight:\u003C/span> \u003Cspan class=\"hljs-number\">10\u003C/span>\n\u003Cspan class=\"hljs-attr\">aliases:\u003C/span> [\u003Cspan class=\"hljs-string\">/old-url/\u003C/span>, \u003Cspan class=\"hljs-string\">/another-old-url/\u003C/span>]\n\u003Cspan class=\"hljs-attr\">author:\u003C/span>\n  \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">"Matthew Rathbone"\u003C/span>\n  \u003Cspan class=\"hljs-attr\">email:\u003C/span> \u003Cspan class=\"hljs-string\">"matthew@example.com"\u003C/span>\n\u003Cspan class=\"hljs-attr\">params:\u003C/span>\n  \u003Cspan class=\"hljs-attr\">subtitle:\u003C/span> \u003Cspan class=\"hljs-string\">"A comprehensive guide"\u003C/span>\n  \u003Cspan class=\"hljs-attr\">featured_image:\u003C/span> \u003Cspan class=\"hljs-string\">"/images/featured.jpg"\u003C/span>\n\u003Cspan class=\"hljs-attr\">markup:\u003C/span> \u003Cspan class=\"hljs-string\">goldmark\u003C/span>\n\u003Cspan class=\"hljs-meta\">---\u003C/span>\n\u003C/code>\u003C/pre>\u003Cp>\u003Cstrong>Hugo-Specific Features\u003C/strong>:\u003C/p>\n\u003Cul>\n\u003Cli>\u003Ccode>lastmod\u003C/code>: Last modification date\u003C/li>\n\u003Cli>\u003Ccode>weight\u003C/code>: Ordering priority\u003C/li>\n\u003Cli>\u003Ccode>aliases\u003C/code>: URL redirects from old paths\u003C/li>\n\u003Cli>\u003Ccode>params\u003C/code>: Custom parameters for templates\u003C/li>\n\u003Cli>\u003Ccode>markup\u003C/code>: Markdown processor to use\u003C/li>\n\u003C/ul>\n\u003Ch3 id=\"gatsby-front-matter\">Gatsby Front Matter\u003C/h3>\n\u003Cp>Gatsby processes front matter through GraphQL queries:\u003C/p>\n\u003Cpre>\u003Ccode class=\"hljs language-yaml\">\u003Cspan class=\"hljs-meta\">---\u003C/span>\n\u003Cspan class=\"hljs-attr\">title:\u003C/span> \u003Cspan class=\"hljs-string\">"Your Post Title"\u003C/span>\n\u003Cspan class=\"hljs-attr\">date:\u003C/span> \u003Cspan class=\"hljs-string\">"2025-10-30"\u003C/span>\n\u003Cspan class=\"hljs-attr\">slug:\u003C/span> \u003Cspan class=\"hljs-string\">"/blog/your-post-title"\u003C/span>\n\u003Cspan class=\"hljs-attr\">featuredImage:\u003C/span> \u003Cspan class=\"hljs-string\">"./images/featured.jpg"\u003C/span>\n\u003Cspan class=\"hljs-attr\">excerpt:\u003C/span> \u003Cspan class=\"hljs-string\">"Brief description of the post content"\u003C/span>\n\u003Cspan class=\"hljs-attr\">author:\u003C/span> \u003Cspan class=\"hljs-string\">"Matthew Rathbone"\u003C/span>\n\u003Cspan class=\"hljs-attr\">categories:\u003C/span> [\u003Cspan class=\"hljs-string\">"Tutorial"\u003C/span>, \u003Cspan class=\"hljs-string\">"Markdown"\u003C/span>]\n\u003Cspan class=\"hljs-attr\">tags:\u003C/span> [\u003Cspan class=\"hljs-string\">"gatsby"\u003C/span>, \u003Cspan class=\"hljs-string\">"markdown"\u003C/span>, \u003Cspan class=\"hljs-string\">"static-site"\u003C/span>]\n\u003Cspan class=\"hljs-attr\">published:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n\u003Cspan class=\"hljs-meta\">---\u003C/span>\n\u003C/code>\u003C/pre>\u003Ch2 id=\"advanced-front-matter-techniques\">Advanced Front Matter Techniques\u003C/h2>\n\u003Ch3 id=\"custom-fields-and-structured-data\">Custom Fields and Structured Data\u003C/h3>\n\u003Cp>Create custom fields for specific use cases:\u003C/p>\n\u003Cpre>\u003Ccode class=\"hljs language-yaml\">\u003Cspan class=\"hljs-meta\">---\u003C/span>\n\u003Cspan class=\"hljs-attr\">title:\u003C/span> \u003Cspan class=\"hljs-string\">"API Documentation: User Authentication"\u003C/span>\n\u003Cspan class=\"hljs-attr\">type:\u003C/span> \u003Cspan class=\"hljs-string\">"api-doc"\u003C/span>\n\u003Cspan class=\"hljs-attr\">version:\u003C/span> \u003Cspan class=\"hljs-string\">"2.1"\u003C/span>\n\u003Cspan class=\"hljs-attr\">api:\u003C/span>\n  \u003Cspan class=\"hljs-attr\">endpoint:\u003C/span> \u003Cspan class=\"hljs-string\">"/auth/login"\u003C/span>\n  \u003Cspan class=\"hljs-attr\">method:\u003C/span> \u003Cspan class=\"hljs-string\">"POST"\u003C/span>\n  \u003Cspan class=\"hljs-attr\">deprecated:\u003C/span> \u003Cspan class=\"hljs-literal\">false\u003C/span>\n  \u003Cspan class=\"hljs-attr\">rate_limit:\u003C/span> \u003Cspan class=\"hljs-number\">100\u003C/span>\n\u003Cspan class=\"hljs-attr\">related_endpoints:\u003C/span>\n  \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">"/auth/refresh"\u003C/span>\n  \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">"/auth/logout"\u003C/span>\n\u003Cspan class=\"hljs-attr\">code_examples:\u003C/span>\n  \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">language:\u003C/span> \u003Cspan class=\"hljs-string\">"javascript"\u003C/span>\n    \u003Cspan class=\"hljs-attr\">file:\u003C/span> \u003Cspan class=\"hljs-string\">"examples/auth-login.js"\u003C/span>\n  \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">language:\u003C/span> \u003Cspan class=\"hljs-string\">"python"\u003C/span>\n    \u003Cspan class=\"hljs-attr\">file:\u003C/span> \u003Cspan class=\"hljs-string\">"examples/auth-login.py"\u003C/span>\n\u003Cspan class=\"hljs-meta\">---\u003C/span>\n\u003C/code>\u003C/pre>\u003Ch3 id=\"seo-and-social-media-optimization\">SEO and Social Media Optimization\u003C/h3>\n\u003Cp>Enhanced metadata for search engines and social platforms:\u003C/p>\n\u003Cpre>\u003Ccode class=\"hljs language-yaml\">\u003Cspan class=\"hljs-meta\">---\u003C/span>\n\u003Cspan class=\"hljs-attr\">title:\u003C/span> \u003Cspan class=\"hljs-string\">"Complete Markdown Guide"\u003C/span>\n\u003Cspan class=\"hljs-attr\">description:\u003C/span> \u003Cspan class=\"hljs-string\">"Master Markdown with this comprehensive tutorial"\u003C/span>\n\u003Cspan class=\"hljs-attr\">keywords:\u003C/span> [\u003Cspan class=\"hljs-string\">markdown\u003C/span>, \u003Cspan class=\"hljs-string\">tutorial\u003C/span>, \u003Cspan class=\"hljs-string\">documentation\u003C/span>]\n\u003Cspan class=\"hljs-comment\"># Open Graph metadata\u003C/span>\n\u003Cspan class=\"hljs-attr\">og:\u003C/span>\n  \u003Cspan class=\"hljs-attr\">type:\u003C/span> \u003Cspan class=\"hljs-string\">"article"\u003C/span>\n  \u003Cspan class=\"hljs-attr\">image:\u003C/span> \u003Cspan class=\"hljs-string\">"/images/og-markdown-guide.jpg"\u003C/span>\n  \u003Cspan class=\"hljs-attr\">url:\u003C/span> \u003Cspan class=\"hljs-string\">"https://blog.markdowntools.com/markdown-guide"\u003C/span>\n\u003Cspan class=\"hljs-comment\"># Twitter Card metadata\u003C/span>\n\u003Cspan class=\"hljs-attr\">twitter:\u003C/span>\n  \u003Cspan class=\"hljs-attr\">card:\u003C/span> \u003Cspan class=\"hljs-string\">"summary_large_image"\u003C/span>\n  \u003Cspan class=\"hljs-attr\">creator:\u003C/span> \u003Cspan class=\"hljs-string\">"@markdowntools"\u003C/span>\n  \u003Cspan class=\"hljs-attr\">image:\u003C/span> \u003Cspan class=\"hljs-string\">"/images/twitter-card.jpg"\u003C/span>\n\u003Cspan class=\"hljs-comment\"># Schema.org structured data\u003C/span>\n\u003Cspan class=\"hljs-attr\">schema:\u003C/span>\n  \u003Cspan class=\"hljs-attr\">type:\u003C/span> \u003Cspan class=\"hljs-string\">"TechnicalArticle"\u003C/span>\n  \u003Cspan class=\"hljs-attr\">difficulty:\u003C/span> \u003Cspan class=\"hljs-string\">"beginner"\u003C/span>\n  \u003Cspan class=\"hljs-attr\">time_required:\u003C/span> \u003Cspan class=\"hljs-string\">"PT30M"\u003C/span>\n\u003Cspan class=\"hljs-meta\">---\u003C/span>\n\u003C/code>\u003C/pre>\u003Ch3 id=\"multilingual-support\">Multilingual Support\u003C/h3>\n\u003Cp>Support for multiple languages and internationalization:\u003C/p>\n\u003Cpre>\u003Ccode class=\"hljs language-yaml\">\u003Cspan class=\"hljs-meta\">---\u003C/span>\n\u003Cspan class=\"hljs-attr\">title:\u003C/span> \u003Cspan class=\"hljs-string\">"Markdown Tutorial"\u003C/span>\n\u003Cspan class=\"hljs-attr\">date:\u003C/span> \u003Cspan class=\"hljs-number\">2025-10-30\u003C/span>\n\u003Cspan class=\"hljs-attr\">lang:\u003C/span> \u003Cspan class=\"hljs-string\">"en"\u003C/span>\n\u003Cspan class=\"hljs-attr\">translations:\u003C/span>\n  \u003Cspan class=\"hljs-attr\">es:\u003C/span> \u003Cspan class=\"hljs-string\">"/es/tutorial-markdown"\u003C/span>\n  \u003Cspan class=\"hljs-attr\">fr:\u003C/span> \u003Cspan class=\"hljs-string\">"/fr/tutoriel-markdown"\u003C/span>\n  \u003Cspan class=\"hljs-attr\">de:\u003C/span> \u003Cspan class=\"hljs-string\">"/de/markdown-anleitung"\u003C/span>\n\u003Cspan class=\"hljs-attr\">hreflang:\u003C/span>\n  \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">lang:\u003C/span> \u003Cspan class=\"hljs-string\">"en"\u003C/span>\n    \u003Cspan class=\"hljs-attr\">url:\u003C/span> \u003Cspan class=\"hljs-string\">"/markdown-tutorial"\u003C/span>\n  \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">lang:\u003C/span> \u003Cspan class=\"hljs-string\">"es"\u003C/span> \n    \u003Cspan class=\"hljs-attr\">url:\u003C/span> \u003Cspan class=\"hljs-string\">"/es/tutorial-markdown"\u003C/span>\n\u003Cspan class=\"hljs-meta\">---\u003C/span>\n\u003C/code>\u003C/pre>\u003Ch3 id=\"content-series-and-navigation\">Content Series and Navigation\u003C/h3>\n\u003Cp>Organize related content into series:\u003C/p>\n\u003Cpre>\u003Ccode class=\"hljs language-yaml\">\u003Cspan class=\"hljs-meta\">---\u003C/span>\n\u003Cspan class=\"hljs-attr\">title:\u003C/span> \u003Cspan class=\"hljs-string\">"Markdown Tables: Part 2 - Advanced Features"\u003C/span>\n\u003Cspan class=\"hljs-attr\">series:\u003C/span> \n  \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">"Mastering Markdown"\u003C/span>\n  \u003Cspan class=\"hljs-attr\">part:\u003C/span> \u003Cspan class=\"hljs-number\">2\u003C/span>\n  \u003Cspan class=\"hljs-attr\">total:\u003C/span> \u003Cspan class=\"hljs-number\">5\u003C/span>\n\u003Cspan class=\"hljs-attr\">navigation:\u003C/span>\n  \u003Cspan class=\"hljs-attr\">previous:\u003C/span>\n    \u003Cspan class=\"hljs-attr\">title:\u003C/span> \u003Cspan class=\"hljs-string\">"Markdown Tables: Part 1 - Basics"\u003C/span>\n    \u003Cspan class=\"hljs-attr\">url:\u003C/span> \u003Cspan class=\"hljs-string\">"/markdown-tables-part-1"\u003C/span>\n  \u003Cspan class=\"hljs-attr\">next:\u003C/span>\n    \u003Cspan class=\"hljs-attr\">title:\u003C/span> \u003Cspan class=\"hljs-string\">"Markdown Tables: Part 3 - Styling"\u003C/span>\n    \u003Cspan class=\"hljs-attr\">url:\u003C/span> \u003Cspan class=\"hljs-string\">"/markdown-tables-part-3"\u003C/span>\n\u003Cspan class=\"hljs-attr\">related_posts:\u003C/span>\n  \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">"/markdown-syntax-guide"\u003C/span>\n  \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">"/advanced-markdown-techniques"\u003C/span>\n\u003Cspan class=\"hljs-meta\">---\u003C/span>\n\u003C/code>\u003C/pre>\u003Ch2 id=\"working-with-front-matter-in-code\">Working with Front Matter in Code\u003C/h2>\n\u003Ch3 id=\"parsing-front-matter-with-javascript\">Parsing Front Matter with JavaScript\u003C/h3>\n\u003Cpre>\u003Ccode class=\"hljs language-javascript\">\u003Cspan class=\"hljs-keyword\">const\u003C/span> yaml = \u003Cspan class=\"hljs-built_in\">require\u003C/span>(\u003Cspan class=\"hljs-string\">'js-yaml'\u003C/span>);\n\u003Cspan class=\"hljs-keyword\">const\u003C/span> fs = \u003Cspan class=\"hljs-built_in\">require\u003C/span>(\u003Cspan class=\"hljs-string\">'fs'\u003C/span>);\n\n\u003Cspan class=\"hljs-keyword\">function\u003C/span> \u003Cspan class=\"hljs-title function_\">parseFrontMatter\u003C/span>(\u003Cspan class=\"hljs-params\">filePath\u003C/span>) {\n  \u003Cspan class=\"hljs-keyword\">const\u003C/span> fileContent = fs.\u003Cspan class=\"hljs-title function_\">readFileSync\u003C/span>(filePath, \u003Cspan class=\"hljs-string\">'utf8'\u003C/span>);\n  \u003Cspan class=\"hljs-keyword\">const\u003C/span> frontMatterRegex = \u003Cspan class=\"hljs-regexp\">/^---\\n([\\s\\S]*?)\\n---\\n([\\s\\S]*)$/\u003C/span>;\n  \u003Cspan class=\"hljs-keyword\">const\u003C/span> match = fileContent.\u003Cspan class=\"hljs-title function_\">match\u003C/span>(frontMatterRegex);\n  \n  \u003Cspan class=\"hljs-keyword\">if\u003C/span> (!match) {\n    \u003Cspan class=\"hljs-keyword\">return\u003C/span> { \u003Cspan class=\"hljs-attr\">frontMatter\u003C/span>: {}, \u003Cspan class=\"hljs-attr\">content\u003C/span>: fileContent };\n  }\n  \n  \u003Cspan class=\"hljs-keyword\">try\u003C/span> {\n    \u003Cspan class=\"hljs-keyword\">const\u003C/span> frontMatter = yaml.\u003Cspan class=\"hljs-title function_\">load\u003C/span>(match[\u003Cspan class=\"hljs-number\">1\u003C/span>]);\n    \u003Cspan class=\"hljs-keyword\">const\u003C/span> content = match[\u003Cspan class=\"hljs-number\">2\u003C/span>];\n    \n    \u003Cspan class=\"hljs-keyword\">return\u003C/span> { frontMatter, content };\n  } \u003Cspan class=\"hljs-keyword\">catch\u003C/span> (error) {\n    \u003Cspan class=\"hljs-variable language_\">console\u003C/span>.\u003Cspan class=\"hljs-title function_\">error\u003C/span>(\u003Cspan class=\"hljs-string\">'Error parsing YAML front matter:'\u003C/span>, error);\n    \u003Cspan class=\"hljs-keyword\">return\u003C/span> { \u003Cspan class=\"hljs-attr\">frontMatter\u003C/span>: {}, \u003Cspan class=\"hljs-attr\">content\u003C/span>: fileContent };\n  }\n}\n\n\u003Cspan class=\"hljs-comment\">// Usage\u003C/span>\n\u003Cspan class=\"hljs-keyword\">const\u003C/span> { frontMatter, content } = \u003Cspan class=\"hljs-title function_\">parseFrontMatter\u003C/span>(\u003Cspan class=\"hljs-string\">'post.md'\u003C/span>);\n\u003Cspan class=\"hljs-variable language_\">console\u003C/span>.\u003Cspan class=\"hljs-title function_\">log\u003C/span>(\u003Cspan class=\"hljs-string\">'Title:'\u003C/span>, frontMatter.\u003Cspan class=\"hljs-property\">title\u003C/span>);\n\u003Cspan class=\"hljs-variable language_\">console\u003C/span>.\u003Cspan class=\"hljs-title function_\">log\u003C/span>(\u003Cspan class=\"hljs-string\">'Author:'\u003C/span>, frontMatter.\u003Cspan class=\"hljs-property\">author\u003C/span>);\n\u003C/code>\u003C/pre>\u003Ch3 id=\"python-front-matter-processing\">Python Front Matter Processing\u003C/h3>\n\u003Cpre>\u003Ccode class=\"hljs language-python\">\u003Cspan class=\"hljs-keyword\">import\u003C/span> yaml\n\u003Cspan class=\"hljs-keyword\">import\u003C/span> re\n\u003Cspan class=\"hljs-keyword\">from\u003C/span> pathlib \u003Cspan class=\"hljs-keyword\">import\u003C/span> Path\n\n\u003Cspan class=\"hljs-keyword\">def\u003C/span> \u003Cspan class=\"hljs-title function_\">parse_front_matter\u003C/span>(\u003Cspan class=\"hljs-params\">file_path\u003C/span>):\n    \u003Cspan class=\"hljs-string\">"""Parse front matter from a Markdown file."""\u003C/span>\n    content = Path(file_path).read_text(encoding=\u003Cspan class=\"hljs-string\">'utf-8'\u003C/span>)\n    \n    \u003Cspan class=\"hljs-comment\"># Match front matter pattern\u003C/span>\n    pattern = \u003Cspan class=\"hljs-string\">r'^---\\n(.*?)\\n---\\n(.*)$'\u003C/span>\n    \u003Cspan class=\"hljs-keyword\">match\u003C/span> = re.\u003Cspan class=\"hljs-keyword\">match\u003C/span>(pattern, content, re.DOTALL)\n    \n    \u003Cspan class=\"hljs-keyword\">if\u003C/span> \u003Cspan class=\"hljs-keyword\">not\u003C/span> \u003Cspan class=\"hljs-keyword\">match\u003C/span>:\n        \u003Cspan class=\"hljs-keyword\">return\u003C/span> {}, content\n    \n    \u003Cspan class=\"hljs-keyword\">try\u003C/span>:\n        front_matter = yaml.safe_load(\u003Cspan class=\"hljs-keyword\">match\u003C/span>.group(\u003Cspan class=\"hljs-number\">1\u003C/span>))\n        markdown_content = \u003Cspan class=\"hljs-keyword\">match\u003C/span>.group(\u003Cspan class=\"hljs-number\">2\u003C/span>)\n        \u003Cspan class=\"hljs-keyword\">return\u003C/span> front_matter, markdown_content\n    \u003Cspan class=\"hljs-keyword\">except\u003C/span> yaml.YAMLError \u003Cspan class=\"hljs-keyword\">as\u003C/span> e:\n        \u003Cspan class=\"hljs-built_in\">print\u003C/span>(\u003Cspan class=\"hljs-string\">f"Error parsing YAML: \u003Cspan class=\"hljs-subst\">{e}\u003C/span>"\u003C/span>)\n        \u003Cspan class=\"hljs-keyword\">return\u003C/span> {}, content\n\n\u003Cspan class=\"hljs-comment\"># Usage\u003C/span>\nfront_matter, content = parse_front_matter(\u003Cspan class=\"hljs-string\">'post.md'\u003C/span>)\n\u003Cspan class=\"hljs-built_in\">print\u003C/span>(\u003Cspan class=\"hljs-string\">f"Title: \u003Cspan class=\"hljs-subst\">{front_matter.get(\u003Cspan class=\"hljs-string\">'title'\u003C/span>)}\u003C/span>"\u003C/span>)\n\u003Cspan class=\"hljs-built_in\">print\u003C/span>(\u003Cspan class=\"hljs-string\">f"Date: \u003Cspan class=\"hljs-subst\">{front_matter.get(\u003Cspan class=\"hljs-string\">'date'\u003C/span>)}\u003C/span>"\u003C/span>)\n\u003C/code>\u003C/pre>\u003Ch2 id=\"front-matter-validation-and-best-practices\">Front Matter Validation and Best Practices\u003C/h2>\n\u003Ch3 id=\"schema-validation\">Schema Validation\u003C/h3>\n\u003Cp>Define schemas to validate front matter structure:\u003C/p>\n\u003Cpre>\u003Ccode class=\"hljs language-yaml\">\u003Cspan class=\"hljs-comment\"># schema.yml - Front matter validation schema\u003C/span>\n\u003Cspan class=\"hljs-attr\">type:\u003C/span> \u003Cspan class=\"hljs-string\">object\u003C/span>\n\u003Cspan class=\"hljs-attr\">required:\u003C/span>\n  \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">title\u003C/span>\n  \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">date\u003C/span>\n  \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">author\u003C/span>\n\u003Cspan class=\"hljs-attr\">properties:\u003C/span>\n  \u003Cspan class=\"hljs-attr\">title:\u003C/span>\n    \u003Cspan class=\"hljs-attr\">type:\u003C/span> \u003Cspan class=\"hljs-string\">string\u003C/span>\n    \u003Cspan class=\"hljs-attr\">minLength:\u003C/span> \u003Cspan class=\"hljs-number\">1\u003C/span>\n    \u003Cspan class=\"hljs-attr\">maxLength:\u003C/span> \u003Cspan class=\"hljs-number\">100\u003C/span>\n  \u003Cspan class=\"hljs-attr\">date:\u003C/span>\n    \u003Cspan class=\"hljs-attr\">type:\u003C/span> \u003Cspan class=\"hljs-string\">string\u003C/span>\n    \u003Cspan class=\"hljs-attr\">pattern:\u003C/span> \u003Cspan class=\"hljs-string\">'^\\d{4}-\\d{2}-\\d{2}$'\u003C/span>\n  \u003Cspan class=\"hljs-attr\">author:\u003C/span>\n    \u003Cspan class=\"hljs-attr\">type:\u003C/span> \u003Cspan class=\"hljs-string\">string\u003C/span>\n    \u003Cspan class=\"hljs-attr\">minLength:\u003C/span> \u003Cspan class=\"hljs-number\">1\u003C/span>\n  \u003Cspan class=\"hljs-attr\">description:\u003C/span>\n    \u003Cspan class=\"hljs-attr\">type:\u003C/span> \u003Cspan class=\"hljs-string\">string\u003C/span>\n    \u003Cspan class=\"hljs-attr\">minLength:\u003C/span> \u003Cspan class=\"hljs-number\">50\u003C/span>\n    \u003Cspan class=\"hljs-attr\">maxLength:\u003C/span> \u003Cspan class=\"hljs-number\">160\u003C/span>\n  \u003Cspan class=\"hljs-attr\">tags:\u003C/span>\n    \u003Cspan class=\"hljs-attr\">type:\u003C/span> \u003Cspan class=\"hljs-string\">array\u003C/span>\n    \u003Cspan class=\"hljs-attr\">items:\u003C/span>\n      \u003Cspan class=\"hljs-attr\">type:\u003C/span> \u003Cspan class=\"hljs-string\">string\u003C/span>\n    \u003Cspan class=\"hljs-attr\">maxItems:\u003C/span> \u003Cspan class=\"hljs-number\">10\u003C/span>\n  \u003Cspan class=\"hljs-attr\">published:\u003C/span>\n    \u003Cspan class=\"hljs-attr\">type:\u003C/span> \u003Cspan class=\"hljs-string\">boolean\u003C/span>\n    \u003Cspan class=\"hljs-attr\">default:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n\u003C/code>\u003C/pre>\u003Ch3 id=\"validation-script\">Validation Script\u003C/h3>\n\u003Cpre>\u003Ccode class=\"hljs language-python\">\u003Cspan class=\"hljs-keyword\">import\u003C/span> yaml\n\u003Cspan class=\"hljs-keyword\">import\u003C/span> jsonschema\n\u003Cspan class=\"hljs-keyword\">from\u003C/span> pathlib \u003Cspan class=\"hljs-keyword\">import\u003C/span> Path\n\n\u003Cspan class=\"hljs-keyword\">def\u003C/span> \u003Cspan class=\"hljs-title function_\">validate_front_matter\u003C/span>(\u003Cspan class=\"hljs-params\">file_path, schema_path\u003C/span>):\n    \u003Cspan class=\"hljs-string\">"""Validate front matter against a JSON schema."""\u003C/span>\n    \n    \u003Cspan class=\"hljs-comment\"># Load schema\u003C/span>\n    \u003Cspan class=\"hljs-keyword\">with\u003C/span> \u003Cspan class=\"hljs-built_in\">open\u003C/span>(schema_path, \u003Cspan class=\"hljs-string\">'r'\u003C/span>) \u003Cspan class=\"hljs-keyword\">as\u003C/span> f:\n        schema = yaml.safe_load(f)\n    \n    \u003Cspan class=\"hljs-comment\"># Parse front matter\u003C/span>\n    front_matter, _ = parse_front_matter(file_path)\n    \n    \u003Cspan class=\"hljs-keyword\">try\u003C/span>:\n        jsonschema.validate(front_matter, schema)\n        \u003Cspan class=\"hljs-built_in\">print\u003C/span>(\u003Cspan class=\"hljs-string\">f"✅ \u003Cspan class=\"hljs-subst\">{file_path}\u003C/span>: Front matter is valid"\u003C/span>)\n        \u003Cspan class=\"hljs-keyword\">return\u003C/span> \u003Cspan class=\"hljs-literal\">True\u003C/span>\n    \u003Cspan class=\"hljs-keyword\">except\u003C/span> jsonschema.exceptions.ValidationError \u003Cspan class=\"hljs-keyword\">as\u003C/span> e:\n        \u003Cspan class=\"hljs-built_in\">print\u003C/span>(\u003Cspan class=\"hljs-string\">f"❌ \u003Cspan class=\"hljs-subst\">{file_path}\u003C/span>: \u003Cspan class=\"hljs-subst\">{e.message}\u003C/span>"\u003C/span>)\n        \u003Cspan class=\"hljs-keyword\">return\u003C/span> \u003Cspan class=\"hljs-literal\">False\u003C/span>\n\n\u003Cspan class=\"hljs-comment\"># Validate all posts\u003C/span>\nposts_dir = Path(\u003Cspan class=\"hljs-string\">'_posts'\u003C/span>)\nschema_file = \u003Cspan class=\"hljs-string\">'front-matter-schema.yml'\u003C/span>\n\n\u003Cspan class=\"hljs-keyword\">for\u003C/span> post_file \u003Cspan class=\"hljs-keyword\">in\u003C/span> posts_dir.glob(\u003Cspan class=\"hljs-string\">'*.md'\u003C/span>):\n    validate_front_matter(post_file, schema_file)\n\u003C/code>\u003C/pre>\u003Ch2 id=\"automation-and-templates\">Automation and Templates\u003C/h2>\n\u003Ch3 id=\"front-matter-templates\">Front Matter Templates\u003C/h3>\n\u003Cp>Create templates for consistent front matter:\u003C/p>\n\u003Cpre>\u003Ccode class=\"hljs language-yaml\">\u003Cspan class=\"hljs-comment\"># templates/blog-post.yml\u003C/span>\n\u003Cspan class=\"hljs-meta\">---\u003C/span>\n\u003Cspan class=\"hljs-attr\">title:\u003C/span> \u003Cspan class=\"hljs-string\">"\u003Cspan class=\"hljs-template-variable\">{{ title }}\u003C/span>"\u003C/span>\n\u003Cspan class=\"hljs-attr\">description:\u003C/span> \u003Cspan class=\"hljs-string\">"\u003Cspan class=\"hljs-template-variable\">{{ description }}\u003C/span>"\u003C/span>\n\u003Cspan class=\"hljs-attr\">date:\u003C/span> {{ \u003Cspan class=\"hljs-string\">date\u003C/span> }}\n\u003Cspan class=\"hljs-attr\">author:\u003C/span> \u003Cspan class=\"hljs-string\">"\u003Cspan class=\"hljs-template-variable\">{{ author | default('Matthew Rathbone') }}\u003C/span>"\u003C/span>\n\u003Cspan class=\"hljs-attr\">category:\u003C/span> \u003Cspan class=\"hljs-string\">"\u003Cspan class=\"hljs-template-variable\">{{ category | default('Tutorial') }}\u003C/span>"\u003C/span>\n\u003Cspan class=\"hljs-attr\">tags:\u003C/span> {{ \u003Cspan class=\"hljs-string\">tags\u003C/span> \u003Cspan class=\"hljs-string\">|\u003C/span> \u003Cspan class=\"hljs-string\">default(\u003C/span>[\u003Cspan class=\"hljs-string\">'markdown'\u003C/span>]\u003Cspan class=\"hljs-string\">)\u003C/span> }}\n\u003Cspan class=\"hljs-attr\">published:\u003C/span> {{ \u003Cspan class=\"hljs-string\">published\u003C/span> \u003Cspan class=\"hljs-string\">|\u003C/span> \u003Cspan class=\"hljs-string\">default(true)\u003C/span> }}\n\u003Cspan class=\"hljs-attr\">comments:\u003C/span> {{ \u003Cspan class=\"hljs-string\">comments\u003C/span> \u003Cspan class=\"hljs-string\">|\u003C/span> \u003Cspan class=\"hljs-string\">default(true)\u003C/span> }}\n\u003Cspan class=\"hljs-attr\">image:\u003C/span>\n  \u003Cspan class=\"hljs-attr\">asset:\u003C/span> \u003Cspan class=\"hljs-string\">"\u003Cspan class=\"hljs-template-variable\">{{ image_asset }}\u003C/span>"\u003C/span>\n  \u003Cspan class=\"hljs-attr\">alt:\u003C/span> \u003Cspan class=\"hljs-string\">"\u003Cspan class=\"hljs-template-variable\">{{ image_alt }}\u003C/span>"\u003C/span>\n\u003Cspan class=\"hljs-attr\">seo:\u003C/span>\n  \u003Cspan class=\"hljs-attr\">canonical:\u003C/span> \u003Cspan class=\"hljs-string\">"\u003Cspan class=\"hljs-template-variable\">{{ canonical_url }}\u003C/span>"\u003C/span>\n  \u003Cspan class=\"hljs-attr\">robots:\u003C/span> \u003Cspan class=\"hljs-string\">"\u003Cspan class=\"hljs-template-variable\">{{ robots | default('index,follow') }}\u003C/span>"\u003C/span>\n\u003Cspan class=\"hljs-meta\">---\u003C/span>\n\u003C/code>\u003C/pre>\u003Ch3 id=\"automated-front-matter-generation\">Automated Front Matter Generation\u003C/h3>\n\u003Cpre>\u003Ccode class=\"hljs language-javascript\">\u003Cspan class=\"hljs-comment\">// generate-frontmatter.js\u003C/span>\n\u003Cspan class=\"hljs-keyword\">const\u003C/span> fs = \u003Cspan class=\"hljs-built_in\">require\u003C/span>(\u003Cspan class=\"hljs-string\">'fs'\u003C/span>);\n\u003Cspan class=\"hljs-keyword\">const\u003C/span> yaml = \u003Cspan class=\"hljs-built_in\">require\u003C/span>(\u003Cspan class=\"hljs-string\">'js-yaml'\u003C/span>);\n\u003Cspan class=\"hljs-keyword\">const\u003C/span> { prompt } = \u003Cspan class=\"hljs-built_in\">require\u003C/span>(\u003Cspan class=\"hljs-string\">'inquirer'\u003C/span>);\n\n\u003Cspan class=\"hljs-keyword\">async\u003C/span> \u003Cspan class=\"hljs-keyword\">function\u003C/span> \u003Cspan class=\"hljs-title function_\">generateFrontMatter\u003C/span>(\u003Cspan class=\"hljs-params\">\u003C/span>) {\n  \u003Cspan class=\"hljs-keyword\">const\u003C/span> answers = \u003Cspan class=\"hljs-keyword\">await\u003C/span> \u003Cspan class=\"hljs-title function_\">prompt\u003C/span>([\n    {\n      \u003Cspan class=\"hljs-attr\">type\u003C/span>: \u003Cspan class=\"hljs-string\">'input'\u003C/span>,\n      \u003Cspan class=\"hljs-attr\">name\u003C/span>: \u003Cspan class=\"hljs-string\">'title'\u003C/span>,\n      \u003Cspan class=\"hljs-attr\">message\u003C/span>: \u003Cspan class=\"hljs-string\">'Post title:'\u003C/span>,\n      \u003Cspan class=\"hljs-attr\">validate\u003C/span>: \u003Cspan class=\"hljs-function\">\u003Cspan class=\"hljs-params\">input\u003C/span> =>\u003C/span> input.\u003Cspan class=\"hljs-property\">length\u003C/span> > \u003Cspan class=\"hljs-number\">0\u003C/span>\n    },\n    {\n      \u003Cspan class=\"hljs-attr\">type\u003C/span>: \u003Cspan class=\"hljs-string\">'input'\u003C/span>, \n      \u003Cspan class=\"hljs-attr\">name\u003C/span>: \u003Cspan class=\"hljs-string\">'description'\u003C/span>,\n      \u003Cspan class=\"hljs-attr\">message\u003C/span>: \u003Cspan class=\"hljs-string\">'Post description:'\u003C/span>,\n      \u003Cspan class=\"hljs-attr\">validate\u003C/span>: \u003Cspan class=\"hljs-function\">\u003Cspan class=\"hljs-params\">input\u003C/span> =>\u003C/span> input.\u003Cspan class=\"hljs-property\">length\u003C/span> >= \u003Cspan class=\"hljs-number\">50\u003C/span> && input.\u003Cspan class=\"hljs-property\">length\u003C/span> <= \u003Cspan class=\"hljs-number\">160\u003C/span>\n    },\n    {\n      \u003Cspan class=\"hljs-attr\">type\u003C/span>: \u003Cspan class=\"hljs-string\">'input'\u003C/span>,\n      \u003Cspan class=\"hljs-attr\">name\u003C/span>: \u003Cspan class=\"hljs-string\">'tags'\u003C/span>,\n      \u003Cspan class=\"hljs-attr\">message\u003C/span>: \u003Cspan class=\"hljs-string\">'Tags (comma-separated):'\u003C/span>,\n      \u003Cspan class=\"hljs-attr\">filter\u003C/span>: \u003Cspan class=\"hljs-function\">\u003Cspan class=\"hljs-params\">input\u003C/span> =>\u003C/span> input.\u003Cspan class=\"hljs-title function_\">split\u003C/span>(\u003Cspan class=\"hljs-string\">','\u003C/span>).\u003Cspan class=\"hljs-title function_\">map\u003C/span>(\u003Cspan class=\"hljs-function\">\u003Cspan class=\"hljs-params\">tag\u003C/span> =>\u003C/span> tag.\u003Cspan class=\"hljs-title function_\">trim\u003C/span>())\n    },\n    {\n      \u003Cspan class=\"hljs-attr\">type\u003C/span>: \u003Cspan class=\"hljs-string\">'list'\u003C/span>,\n      \u003Cspan class=\"hljs-attr\">name\u003C/span>: \u003Cspan class=\"hljs-string\">'category'\u003C/span>,\n      \u003Cspan class=\"hljs-attr\">message\u003C/span>: \u003Cspan class=\"hljs-string\">'Category:'\u003C/span>,\n      \u003Cspan class=\"hljs-attr\">choices\u003C/span>: [\u003Cspan class=\"hljs-string\">'Tutorial'\u003C/span>, \u003Cspan class=\"hljs-string\">'Guide'\u003C/span>, \u003Cspan class=\"hljs-string\">'Reference'\u003C/span>, \u003Cspan class=\"hljs-string\">'News'\u003C/span>]\n    }\n  ]);\n\n  \u003Cspan class=\"hljs-keyword\">const\u003C/span> frontMatter = {\n    ...answers,\n    \u003Cspan class=\"hljs-attr\">date\u003C/span>: \u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">Date\u003C/span>().\u003Cspan class=\"hljs-title function_\">toISOString\u003C/span>().\u003Cspan class=\"hljs-title function_\">split\u003C/span>(\u003Cspan class=\"hljs-string\">'T'\u003C/span>)[\u003Cspan class=\"hljs-number\">0\u003C/span>],\n    \u003Cspan class=\"hljs-attr\">author\u003C/span>: \u003Cspan class=\"hljs-string\">'Matthew Rathbone'\u003C/span>,\n    \u003Cspan class=\"hljs-attr\">ai\u003C/span>: \u003Cspan class=\"hljs-literal\">true\u003C/span>,\n    \u003Cspan class=\"hljs-attr\">layout\u003C/span>: \u003Cspan class=\"hljs-string\">'post'\u003C/span>,\n    \u003Cspan class=\"hljs-attr\">published\u003C/span>: \u003Cspan class=\"hljs-literal\">true\u003C/span>,\n    \u003Cspan class=\"hljs-attr\">image\u003C/span>: { \u003Cspan class=\"hljs-attr\">asset\u003C/span>: \u003Cspan class=\"hljs-string\">''\u003C/span> }\n  };\n\n  \u003Cspan class=\"hljs-keyword\">const\u003C/span> yamlString = yaml.\u003Cspan class=\"hljs-title function_\">dump\u003C/span>(frontMatter);\n  \u003Cspan class=\"hljs-variable language_\">console\u003C/span>.\u003Cspan class=\"hljs-title function_\">log\u003C/span>(\u003Cspan class=\"hljs-string\">'\\nGenerated Front Matter:'\u003C/span>);\n  \u003Cspan class=\"hljs-variable language_\">console\u003C/span>.\u003Cspan class=\"hljs-title function_\">log\u003C/span>(\u003Cspan class=\"hljs-string\">'---'\u003C/span>);\n  \u003Cspan class=\"hljs-variable language_\">console\u003C/span>.\u003Cspan class=\"hljs-title function_\">log\u003C/span>(yamlString.\u003Cspan class=\"hljs-title function_\">trim\u003C/span>());\n  \u003Cspan class=\"hljs-variable language_\">console\u003C/span>.\u003Cspan class=\"hljs-title function_\">log\u003C/span>(\u003Cspan class=\"hljs-string\">'---'\u003C/span>);\n}\n\n\u003Cspan class=\"hljs-title function_\">generateFrontMatter\u003C/span>();\n\u003C/code>\u003C/pre>\u003Ch2 id=\"common-issues-and-troubleshooting\">Common Issues and Troubleshooting\u003C/h2>\n\u003Ch3 id=\"yaml-syntax-errors\">YAML Syntax Errors\u003C/h3>\n\u003Cp>Common YAML issues in front matter:\u003C/p>\n\u003Cpre>\u003Ccode class=\"hljs language-yaml\">\u003Cspan class=\"hljs-comment\"># ❌ Incorrect: Unquoted strings with special characters\u003C/span>\n\u003Cspan class=\"hljs-attr\">title: My Post:\u003C/span> \u003Cspan class=\"hljs-string\">A\u003C/span> \u003Cspan class=\"hljs-string\">Guide\u003C/span> \u003Cspan class=\"hljs-string\">to\u003C/span> \u003Cspan class=\"hljs-string\">Success\u003C/span>\n\n\u003Cspan class=\"hljs-comment\"># ✅ Correct: Quote strings with special characters\u003C/span>\n\u003Cspan class=\"hljs-attr\">title:\u003C/span> \u003Cspan class=\"hljs-string\">"My Post: A Guide to Success"\u003C/span>\n\n\u003Cspan class=\"hljs-comment\"># ❌ Incorrect: Inconsistent indentation\u003C/span>\n\u003Cspan class=\"hljs-attr\">tags:\u003C/span>\n  \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">markdown\u003C/span>\n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">tutorial\u003C/span>  \u003Cspan class=\"hljs-comment\"># Wrong indentation\u003C/span>\n\n\u003Cspan class=\"hljs-comment\"># ✅ Correct: Consistent indentation\u003C/span>\n\u003Cspan class=\"hljs-attr\">tags:\u003C/span>\n  \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">markdown\u003C/span>\n  \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">tutorial\u003C/span>\n\n\u003Cspan class=\"hljs-comment\"># ❌ Incorrect: Missing quotes for date strings\u003C/span>\n\u003Cspan class=\"hljs-attr\">date:\u003C/span> \u003Cspan class=\"hljs-number\">2025-10-30 14:30:00\u003C/span>\n\n\u003Cspan class=\"hljs-comment\"># ✅ Correct: Quoted date strings or ISO format\u003C/span>\n\u003Cspan class=\"hljs-attr\">date:\u003C/span> \u003Cspan class=\"hljs-string\">"2025-10-30 14:30:00"\u003C/span>\n\u003Cspan class=\"hljs-comment\"># or\u003C/span>\n\u003Cspan class=\"hljs-attr\">date:\u003C/span> \u003Cspan class=\"hljs-number\">2025-10-30T14:30:00Z\u003C/span>\n\u003C/code>\u003C/pre>\u003Ch3 id=\"encoding-and-special-characters\">Encoding and Special Characters\u003C/h3>\n\u003Cp>Handle special characters properly:\u003C/p>\n\u003Cpre>\u003Ccode class=\"hljs language-yaml\">\u003Cspan class=\"hljs-meta\">---\u003C/span>\n\u003Cspan class=\"hljs-attr\">title:\u003C/span> \u003Cspan class=\"hljs-string\">"Café & Restaurant Guide"\u003C/span>  \u003Cspan class=\"hljs-comment\"># Escaped ampersand\u003C/span>\n\u003Cspan class=\"hljs-attr\">description:\u003C/span> \u003Cspan class=\"hljs-string\">"Guide to finding the best cafés in the city"\u003C/span>\n\u003Cspan class=\"hljs-attr\">excerpt:\u003C/span> \u003Cspan class=\"hljs-string\">|\n  Multi-line content with\n  proper YAML formatting\n  using the pipe (|) operator\n\u003C/span>\u003Cspan class=\"hljs-meta\">---\u003C/span>\n\u003C/code>\u003C/pre>\u003Ch3 id=\"front-matter-not-processing\">Front Matter Not Processing\u003C/h3>\n\u003Cp>Troubleshooting checklist:\u003C/p>\n\u003Col>\n\u003Cli>\u003Cstrong>Verify Delimiters\u003C/strong>: Ensure front matter starts and ends with \u003Ccode>---\u003C/code>\u003C/li>\n\u003Cli>\u003Cstrong>Check File Encoding\u003C/strong>: Use UTF-8 encoding\u003C/li>\n\u003Cli>\u003Cstrong>Validate YAML\u003C/strong>: Use online YAML validators to check syntax\u003C/li>\n\u003Cli>\u003Cstrong>Review Platform Documentation\u003C/strong>: Different static site generators have specific requirements\u003C/li>\n\u003Cli>\u003Cstrong>Test with Minimal Front Matter\u003C/strong>: Start simple and add complexity gradually\u003C/li>\n\u003C/ol>\n\u003Ch2 id=\"conclusion\">Conclusion\u003C/h2>\n\u003Cp>Markdown front matter transforms simple text files into powerful, structured content that can drive sophisticated websites and documentation systems. By mastering front matter syntax and best practices, you can create maintainable, SEO-optimized content that integrates seamlessly with modern static site generators and content management workflows.\u003C/p>\n\u003Cp>Whether you're building a blog, documentation site, or complex content platform, understanding front matter enables you to leverage the full power of Markdown-based content management. From basic metadata to advanced structured data, front matter provides the foundation for scalable, automated content systems that grow with your needs.\u003C/p>\n\u003Cp>Remember to validate your front matter regularly, maintain consistent schemas across your content, and use automation tools to streamline content creation while ensuring quality and consistency across your entire content library.\u003C/p>\n",[15,19,22,25,28,31,34,37,40,43],{"id":16,"text":17,"level":18},"what-is-markdown-front-matter","What is Markdown Front Matter?",2,{"id":20,"text":21,"level":18},"front-matter-formats","Front Matter Formats",{"id":23,"text":24,"level":18},"essential-front-matter-fields","Essential Front Matter Fields",{"id":26,"text":27,"level":18},"platform-specific-front-matter","Platform-Specific Front Matter",{"id":29,"text":30,"level":18},"advanced-front-matter-techniques","Advanced Front Matter Techniques",{"id":32,"text":33,"level":18},"working-with-front-matter-in-code","Working with Front Matter in Code",{"id":35,"text":36,"level":18},"front-matter-validation-and-best-practices","Front Matter Validation and Best Practices",{"id":38,"text":39,"level":18},"automation-and-templates","Automation and Templates",{"id":41,"text":42,"level":18},"common-issues-and-troubleshooting","Common Issues and Troubleshooting",{"id":44,"text":45,"level":18},"conclusion","Conclusion",[],[48,56,64],{"slug":49,"title":50,"description":51,"excerpt":52,"date":53,"category":9,"author":10,"keywords":54,"readingMinutes":55},"markdown-link-management-cross-referencing-complete-guide","Markdown Link Management and Cross-Referencing: Complete Guide for Documentation Systems and Content Organization","Master advanced Markdown link management techniques for documentation systems, cross-referencing content, and maintaining link integrity across large content repositories. Learn automated link validation, reference management, and organization strategies.","Advanced Markdown link management and cross-referencing systems enable sophisticated documentation architectures that maintain content relationships, ensure link integrity, and provide seamless…","2025-09-27","markdown link management, markdown cross references, documentation links, markdown references, link validation markdown, markdown link organization, content cross-referencing, markdown documentation systems",19,{"slug":57,"title":58,"description":59,"excerpt":60,"date":61,"category":9,"author":10,"keywords":62,"readingMinutes":63},"markdown-version-control-git-integration-complete-guide","Markdown Version Control and Git Integration: Complete Guide for Documentation Workflows and Collaborative Content Management","Master Markdown version control with Git integration for collaborative documentation workflows, automated content management, and efficient technical writing processes. Learn Git hooks, merge strategies, and workflow optimization.","Advanced Markdown version control and Git integration enables sophisticated collaborative documentation workflows that maintain content quality, track changes systematically, and automate content…","2025-09-29","markdown version control, git markdown integration, documentation git workflows, markdown collaboration, git hooks markdown, version control documentation, markdown git best practices, collaborative writing git",22,{"slug":65,"title":66,"description":67,"excerpt":68,"date":69,"category":9,"author":10,"keywords":70,"readingMinutes":71},"markdown-internationalization-multilingual-documentation-complete-guide","Markdown Internationalization and Multilingual Documentation: Complete Guide for Global Content Management, Translation Workflows, and Localization Strategies","Master internationalization in Markdown with comprehensive multilingual documentation systems, automated translation workflows, locale-specific formatting, and global content management strategies for worldwide audiences.","Markdown internationalization and multilingual documentation systems enable technical writers to create, manage, and maintain documentation that serves global audiences across diverse languages,…","2025-12-24","markdown internationalization, multilingual markdown documentation, markdown translation workflows, markdown localization, global documentation markdown, i18n markdown, markdown language support, multilingual content management",14,1792184944034]