# Markdown For All

## Summary
Markdown For All (https://mdforall.com) is a public file-to-Markdown conversion utility for documentation, publishing, cleanup, search, and approved AI knowledge-base workflows. It converts Word, PDF, Excel, PowerPoint, HTML, CSV, JSON, XML, TXT, and supported ZIP files into reviewable Markdown. It preserves durable reading structure rather than exact page layout or executable application logic.

## Best for
- Public, redacted, already-shareable, or approved low-risk documents.
- DOCX, HTML, CSV, JSON, XML, and TXT sources with clear structure.
- Text-based PDFs that need a reviewable draft.
- Documentation, CMS, GitHub, RAG, search, and AI knowledge-base preparation.

## Not for
- Pixel-perfect layout reproduction.
- Scanned PDFs without OCR.
- Spreadsheet formulas, charts, pivots, macros, or hidden workbook logic as a source of truth.
- PowerPoint animation, diagrams, timing, or exact design.
- Public upload of confidential, regulated, customer, financial, medical, legal, credential-containing, or private source files.

## Supported conversion pages
- Word to Markdown: https://mdforall.com/word-to-markdown
- PDF to Markdown: https://mdforall.com/pdf-to-markdown
- Excel to Markdown: https://mdforall.com/excel-to-markdown
- CSV to Markdown: https://mdforall.com/csv-to-markdown
- PowerPoint to Markdown: https://mdforall.com/ppt-to-markdown
- HTML to Markdown: https://mdforall.com/html-to-markdown
- JSON to Markdown: https://mdforall.com/json-to-markdown
- XML to Markdown: https://mdforall.com/xml-to-markdown
- TXT to Markdown: https://mdforall.com/txt-to-markdown

## Machine-readable resources
- Full project brief: https://mdforall.com/llms-full.txt
- Format capabilities JSON: https://mdforall.com/formats.json
- Conversion limits: https://mdforall.com/conversion-limits
- Public changelog: https://mdforall.com/changelog
- Sitemap: https://mdforall.com/sitemap.xml

## File handling
Uploaded files are written to temporary request storage for conversion and removed with request cleanup after creation, including failure or timeout paths. Converted Markdown is returned to the browser and is not intentionally added to a document library or ordinary application logs. Operational infrastructure may record metadata such as IP address, time, URL, status, user agent, request size, duration, and error category.

## Review boundary
Every result must be compared with the source before publication or reliance. Verify names, dates, totals, identifiers, clauses, units, tables, links, reading order, and non-Latin characters.

## Contact
support@mdforall.com

## Last reviewed
2026-07-16
Release: 2026-07-16-geo-r7

## Conversion process
1. The browser uploads one supported file to POST /api/v1/conversions.
2. The Go service applies file-size, type, concurrency, timeout, and archive-safety controls.
3. The relevant converter produces a Markdown draft.
4. The service returns Markdown and warnings.
5. Temporary request files are removed by cleanup handlers.

## Format capability notes

### Convert PDF to Markdown
Markdown For All converts text-based PDFs into reviewable Markdown drafts for documentation, search, and AI knowledge-base cleanup. It can retain useful text structure when the PDF has a usable text layer, but reading order, tables, custom fonts, scanned pages, names, dates, totals, and legal or financial details require manual review. Scanned PDFs should go through OCR before Markdown cleanup.

Preparation:
- Test text selection: Copy a paragraph into a plain editor. Empty or scrambled text indicates OCR or font-mapping problems.
- Inspect page layout: Identify columns, sidebars, forms, repeated headers, footnotes, and visual tables.
- Choose the workflow: Convert text-based pages, OCR scans, or retrieve the original DOCX when possible.
- Define verification points: List names, dates, totals, clauses, units, and page references that must match exactly.
Review:
- Unicode mapping, punctuation, non-Latin characters
- Nested indentation and visual grouping
- Merged cells, form layouts, totals, column order
- Columns, sidebars, headers, footers, page numbers

### Convert Word documents to Markdown
Markdown For All converts Word documents into editable Markdown for documentation, publishing, repositories, and AI knowledge bases. Original DOCX files usually provide a better source than PDF exports because heading styles, lists, links, and simple tables retain semantic structure. Resolve tracked changes, remove private comments, and review text boxes, floating objects, headers, footers, and legacy DOC files before publishing.

Preparation:
- Use styles, not appearance: Apply Heading 1–3 instead of only bolding or enlarging text.
- Resolve review data: Accept or reject tracked changes and remove comments that should not appear in output.
- Simplify layout objects: Move essential text out of text boxes, floating shapes, and decorative sidebars.
- Check the draft: Compare headings, list nesting, tables, links, notes, and image context with the original.
Review:
- Manually bolded pseudo-headings may remain paragraphs
- Deep nesting and custom numbering can flatten
- Merged cells, nested tables, and complex widths
- Text boxes, floating objects, page headers/footers, exact pagination

### Convert Excel spreadsheets to Markdown
Markdown For All converts spreadsheet cells into readable Markdown tables for reports, documentation, and lightweight data references. It works best with a small regular grid that has one header row and consistent columns. Markdown is not a spreadsheet engine: formulas, pivot tables, charts, merged cells, hidden rows, workbook logic, and very wide sheets require manual decisions and verification.

Preparation:
- Choose one relevant sheet: Copy the data needed for publication into a dedicated clean sheet.
- Create a regular grid: Use one header row, unmerge cells, remove empty spacer columns, and expose hidden data that matters.
- Decide how formulas appear: Choose whether Markdown should show calculated values, formulas as text, or a written explanation.
- Reshape for readers: Split wide tables, summarize secondary fields, or convert records into short sections and lists.
Review:
- Formatting-dependent meaning and comments
- Multi-row headers, merged cells, hidden rows/columns
- Formulas, dependencies, macros, recalculation
- Charts, pivots, slicers, conditional formatting

### Convert PowerPoint slides to Markdown
Markdown For All turns PowerPoint text into a reviewable document outline. It is useful for extracting slide titles, body bullets, and available speaker notes for documentation or knowledge-base cleanup. PowerPoint is a visual canvas, so animations, diagrams, chart meaning, spatial relationships, image-only text, and exact design are not reproduced. Review slide order, nesting, notes, and visual evidence before publishing.

Preparation:
- Give every slide a descriptive title: Titles create stable section boundaries after conversion.
- Put essential claims in text: Do not rely only on images, diagrams, or screenshots to carry meaning.
- Export or review speaker notes: Decide whether notes belong in the final document and remove private presenter comments.
- Make sequence explicit: Check slide order, bullet nesting, repeated agenda slides, appendices, and hidden slides.
Review:
- Untitled slides and decorative text
- Position-based grouping and deep custom indentation
- Timing, presenter cues, hidden review comments
- Relationships, shapes, animation, visual evidence

### Convert HTML to Markdown
Markdown For All converts static HTML files into cleaner Markdown for documentation migration, publishing, and content cleanup. It works best when the article or documentation text is present in the source HTML. Scripts, styles, navigation, cookie banners, and other page chrome should not become the document. Review relative links, image paths, code blocks, tables, and pages whose content is rendered only by JavaScript.

Preparation:
- Inspect view source: Confirm the useful text exists in the HTML rather than arriving only after JavaScript runs.
- Identify the main region: Keep article or main content; exclude navigation, footer, cookie banner, related widgets, and ads.
- Normalize semantic elements: Use proper headings, lists, links, code, quotes, and simple tables.
- Repair destinations: Resolve relative links and image paths against the final publishing location.
Review:
- CSS-only visual hierarchy
- JavaScript navigation and inaccessible click handlers
- Interactive widgets and syntax behavior
- Responsive layout, lazy-loaded assets, complex table spans

### Convert CSV to a Markdown table
Markdown For All converts regular CSV records into Markdown tables for documentation, public data summaries, and lightweight reference pages. It works best when the file has one clear header row, consistent column counts, a known delimiter, and clean text encoding. Very wide data, missing headers, embedded line breaks, inconsistent quoting, and sensitive exports require preparation and review.

Preparation:
- Confirm delimiter and encoding: Open the file in a plain-text or data tool and confirm commas, tabs, or semicolons are interpreted correctly.
- Add a header row: Use short, unambiguous names and avoid duplicate headers.
- Normalize rows: Fix missing fields, extra delimiters, embedded line breaks, and inconsistent quotes.
- Reduce width: Keep essential columns, split by topic, or turn each record into a short list.
Review:
- Missing, duplicated, or blank column names
- Embedded newlines, inconsistent quoting, delimiter collisions
- Legacy encodings and replacement characters
- Ragged rows and very wide records

### Convert JSON to Markdown
Markdown For All converts JSON into readable Markdown for API documentation, debugging notes, configuration explanations, and AI knowledge-base preparation. Flat records can become tables or lists, while deeply nested objects often remain clearer as fenced code plus a written explanation. Review arrays, null values, identifiers, secrets, ordering assumptions, and data that should not be uploaded publicly.

Preparation:
- Validate the JSON: Fix trailing commas, invalid comments, and encoding errors before conversion.
- Classify the shape: Decide whether it is one object, a record array, a configuration tree, or an API response.
- Remove sensitive values: Redact tokens, credentials, personal identifiers, private URLs, and customer data.
- Choose the representation: Use a table for regular records, sections for concepts, or fenced JSON when syntax matters.
Review:
- Data types are presented as text
- Mixed item shapes and order assumptions
- Deep hierarchy can become verbose or ambiguous
- Comments are not valid standard JSON

### Convert XML to Markdown
Markdown For All converts XML into readable Markdown for technical notes, migration reviews, and knowledge-base preparation. Elements can become sections, lists, tables, or fenced code, but attributes, namespaces, repeated records, mixed text, and deep nesting require deliberate representation. Preserve semantic tag meaning and keep the original XML when machine validation or exact structure matters.

Preparation:
- Validate well-formedness: Fix unclosed tags, invalid entities, and encoding declarations.
- Identify semantic records: Distinguish document sections, repeated data records, metadata, and schema plumbing.
- Choose important attributes: Preserve IDs, types, dates, or labels that readers need; explain namespaces separately.
- Keep an authoritative copy: Retain the XML and schema whenever validation, ordering, or exact machine interchange matters.
Review:
- Generic tag names may need human-friendly explanations
- Namespaces, IDs, and inherited meaning
- Optional fields and heterogeneous child elements
- Mixed content and deep recursion

### Convert plain text to Markdown
Markdown For All turns plain-text files into a Markdown draft for notes, documentation, publishing, and cleanup. Plain text contains little explicit structure, so headings, list nesting, quotes, code blocks, and paragraph boundaries may need editorial decisions. It works best when the source already uses blank lines, consistent prefixes, and readable sections; logs and fixed-width data usually need a specialized workflow.

Preparation:
- Normalize line endings: Remove accidental wrapping and keep intentional blank lines between paragraphs.
- Use consistent labels: Mark titles, sections, bullets, quotes, and code with repeatable patterns.
- Separate logs and code: Keep machine output in fenced blocks rather than turning every line into prose.
- Edit the hierarchy: Decide which labels are headings and whether each section makes sense when read alone.
Review:
- Accidental line wrapping and hard returns
- Inconsistent symbols and nesting
- Tabs, fixed-width columns, copied page layout
- Context, labels, and language identifiers

## Alternatives and comparisons
- Original editable files: Prefer DOCX, XLSX, PPTX, or source HTML over PDF when available because they expose more semantic structure.
- OCR: Required before Markdown cleanup for scanned or image-only PDFs. OCR and Markdown conversion are separate steps.
- Local scripts or self-hosted workflows: Better for sensitive data, repeated batch jobs, custom parsers, or controlled retention.
- Pandoc and similar document tools: Useful in local workflows with broader format ecosystems and explicit command-line control.
- Spreadsheet or database outputs: Keep CSV/XLSX/database exports when exact data types, formulas, filtering, or machine use matter.

## Non-promises
- No pixel-perfect reproduction.
- No OCR in the basic public workflow.
- No guarantee that legal, financial, medical, or compliance details are authoritative.
- No guarantee that complex tables, fonts, diagrams, charts, formulas, or dynamic web applications convert faithfully.
- No recommendation to upload sensitive files to a public service.

## Governance
- Public changelog: https://mdforall.com/changelog
- Known limits: https://mdforall.com/conversion-limits
- Privacy: https://mdforall.com/privacy
- Terms: https://mdforall.com/terms
- Cookie policy: https://mdforall.com/cookie-policy
- Contact: support@mdforall.com