<2-3 sentences summarising what the project addresses and solves, the target audience, and the benefit.> This repository provides a customizable Pandoc Word template (.docx) to enhance Markdown-to-Word exports, addressing the often unappealing default styling. It targets users of note-taking apps (Obsidian, Typora, SiYuan) needing professional, Chinese-typographically-aware document formatting. The solution offers fine-grained control over text, numbering, lists, and more, improving export aesthetics and standardization.

How It Works

It leverages Pandoc's --reference-doc feature with a custom .docx template. Crucially, it integrates Lua filters to extend Pandoc's capabilities for DOCX conversion. These filters enable correct handling of Markdown features poorly supported in DOCX, such as embedded HTML tags, using image title for captions, preserving font colors, and applying distinct styles to code blocks versus inline code.

Quick Start & Requirements

• Usage: Apply via Pandoc command: pandoc input.md --reference-doc <path/to/template.docx> -o output.docx. Integration guides for Typora, SiYuan, and Obsidian (via plugins) are provided.
• Prerequisites: Pandoc, Microsoft Office Word (Windows recommended).
• Links: Detailed Pandoc usage and feature documentation is available via linked blog posts within the README.

Highlighted Details

• Configurable heading numbering and list indentation.
• Custom styling for blockquotes (e.g., figure captions) and line numbers.
• Preservation of inline font color styling from Markdown/HTML.
• Advanced image handling: using title for captions, custom numbering.
• Distinct styling for code blocks and inline code elements.

Maintenance & Community

This project appears to be a personal effort by "Achuan-2," with no explicit mention of a wider community, contributors, sponsorships, or a formal roadmap.

Licensing & Compatibility

• License: No formal open-source license is specified; described as "powered by love/donation."
• Compatibility: Primarily tested on Windows Office Word. Potential issues exist with WPS and Mac Office versions. The lack of a formal license may restrict commercial adoption.

Limitations & Caveats

The primary limitation is the strong Windows Office Word dependency; WPS and Mac Office users may encounter formatting inconsistencies. Reliance on Lua filters adds workflow complexity. The absence of a defined license could be a barrier for commercial adoption or derivative works.