doc to markdown

Design Community

Skill notes

Dual Mode

Mode · Speed · Quality · Use Case Quick (default) · Fast · Good · Drafts, simple documents Heavy · Slower · Best · Final documents, complex layouts

Tool Selection

Format · Quick Mode · Heavy Mode PDF · pymupdf4llm · pymupdf4llm + markitdown DOCX · pandoc + post-processing · pandoc + markitdown PPTX · markitdown · markitdown + pandoc XLSX · markitdown · markitdown

DOCX Post-Processing (automatic)

When converting DOCX via pandoc, 8 cleanups are applied automatically: Problem · Fix · Test coverage Grid tables (+:---+) · Single-column → blockquote, multi-column → pipe table · TestPostprocessPipeline Simple tables ( ---- ----) · Multi-column images → pipe table with captions · TestSimpleTable Image path nesting (media/media/) · Flatten to media/, absolute → relative · test_stats_tracking

CJK Bold Spacing — why and how

DOCX uses run-level styling (no spaces between bold/normal runs in CJK text). Markdown renderers need whitespace around `` to recognize bold boundaries. Rule: if a content span contains any CJK character, ensure both sides have a space — unless already spaced or at line boundary. This handles CJK punctuation, emoji adjacency, and mixed content.

Heavy Mode Workflow

Heavy Mode runs multiple tools in parallel and selects the best segments: Parallel Execution: Run all applicable tools simultaneously Segment Analysis: Parse each output into segments (tables, headings, images, paragraphs) Quality Scoring: Score each segment based on completeness and structure Intelligent Merge: Select best version of each segment across tools

Fluxly profile Runtime and permissions are inferred by Fluxly static checks, not author declarations or runtime test results.
Domain
Design
Author-declared agents
No explicit declaration found; this is not inferred or tested compatibility
Static check
88 / 100 · heuristic scan, not runtime safety proof
Runtime evidence
Not run; no isolated runtime test evidence is currently recorded
Author / version / license
@daymade · no license declared
Token usage
Lean
Setup complexity
Guided setup
External API key
Not required
Operating systems
Windows · WSL
Runtime requirements
Python
Detected file/system behavior
  • Read-only
  • Write / modify
  • Shell exec
Network behavior
Local-only
Install commands
None (reference only)

Heads up: Tool permissions are not declared; actual access depends on the runtime.

Output preview doc-to-markdown.preview
# Merge Outputs Manually

# Merge multiple markdown files
python scripts/merge_outputs.py output1.md output2.md -o merged.md

# Show segment attribution
python scripts/merge_outputs.py output1.md output2.md -o merged.md --verbose

Discussion

Powered by GitHub Discussions. Sign in with GitHub to comment, react, or subscribe.