Add Swift DocC documentation

[DandyLyons]

Summary

• Added comprehensive Swift DocC documentation for both the MarkdownUtilities library and md-utils CLI
• Includes getting started guides, API documentation, command references, and workflow examples
• Covers integration with Hugo, Obsidian, and general Markdown workflows
• Documents all current CLI commands (fm-get, fm-set, fm-list, fm-dump, body, toc, to-text)

Important Note

⚠️ This initial documentation draft was generated with Claude AI and requires human review and revision before being considered final. While the structure and content provide a solid starting point, it should be carefully reviewed for:

• Technical accuracy
• Completeness
• Consistency with actual implementation
• Voice and style
• Examples and code snippets

Documentation Structure

MarkdownUtilities Library

• Getting Started guide
• MarkdownDocument overview
• FrontMatter operations (overview, CRUD)
• Format conversion (plain text)
• Table of Contents generation
• Integration guide

md-utils CLI

• Getting Started guide
• Global options reference
• Command documentation for all commands
• Workflow guides:
  • Shell scripting and automation
  • General Markdown workflows
  • Obsidian integration
  • Hugo static site generation

Test plan

• Review documentation for technical accuracy
• Verify all code examples work as documented
• Check that command syntax matches actual CLI behavior
• Build DocC locally with swift package generate-documentation
• Review generated documentation site for navigation and clarity

🤖 Generated with Claude Code