MediaWiki to Markdown Converter

Transform MediaWiki tables into GitHub Flavored Markdown format for README files, documentation, and more

MediaWiki Input

Markdown Output

About MediaWiki to Markdown Converter

Convert MediaWiki table markup to GitHub Flavored Markdown (GFM) table format. Perfect for creating README files, documentation, GitHub wikis, and any platform that supports Markdown.

Key Features

  • GitHub Flavored Markdown: Generates GFM-compatible table syntax
  • Column Alignment: Support for left, center, right, or default alignment
  • Header Support: Toggle header row formatting
  • MediaWiki Parser: Accurately parses MediaWiki table syntax
  • Automatic Padding: Ensures all rows have consistent column counts
  • File Upload: Upload .wiki files directly
  • Copy & Download: Easy export to .md files

How to Use

  1. Input MediaWiki Table: Paste your MediaWiki table markup or upload a .wiki file
  2. Configure Options: Choose header and alignment preferences
  3. Review Output: The Markdown table generates automatically
  4. Copy to Document: Use the Copy button and paste into your .md file
  5. Download (Optional): Save as .md file for later use

Alignment Options

  • Default: | --- | - No specific alignment
  • Left: | :--- | - Left-aligned columns
  • Center: | :---: | - Center-aligned columns
  • Right: | ---: | - Right-aligned columns

Example Conversion

MediaWiki Input:

{| class="wikitable" border="1"
! Name !! Age !! City !! Department
|-
| John Doe || 28 || New York || Engineering
|-
| Jane Smith || 34 || London || Marketing
|}

Markdown Output:

| Name | Age | City | Department |
| --- | --- | --- | --- |
| John Doe | 28 | New York | Engineering |
| Jane Smith | 34 | London | Marketing |

Common Use Cases

  • GitHub README: Add tables to repository README files
  • Documentation: Convert wiki tables for documentation sites
  • GitHub Wikis: Migrate MediaWiki content to GitHub wikis
  • GitLab/Bitbucket: Create tables for GitLab and Bitbucket markdown
  • Static Site Generators: Use with Jekyll, Hugo, Gatsby, etc.
  • Markdown Editors: Import wiki tables into Typora, Mark Text, etc.

GitHub Flavored Markdown

The converter generates GFM-compatible tables that work on:

  • GitHub (repositories, wikis, issues, pull requests)
  • GitLab (repositories, wikis, merge requests)
  • Bitbucket (repositories, wikis)
  • Stack Overflow and Stack Exchange
  • Reddit (with RES extension)
  • Discord and Slack (with formatting)
  • Most static site generators (Jekyll, Hugo, etc.)

Markdown Table Syntax

GitHub Flavored Markdown table format:

  • Pipes (|): Separate columns
  • Header Row: First row with column names
  • Separator Row: Second row with dashes (---)
  • Data Rows: Subsequent rows with data
  • Alignment: Use colons (:) in separator row

Alignment Syntax

| Left | Center | Right | Default |
| :--- | :---: | ---: | --- |
| Text | Text | Text | Text |

Tips for Best Results

  • Use header row for better table readability
  • Choose appropriate alignment for your data (numbers often right-aligned)
  • Keep cell content concise for better mobile display
  • Test the output in your target platform's preview
  • Use alignment to improve visual hierarchy
  • Consider table width for responsive design

Platform Compatibility

  • GitHub: Full support including alignment
  • GitLab: Full support with all features
  • Bitbucket: Full support for GFM tables
  • Jekyll: Works with kramdown and other processors
  • Hugo: Full support with Goldmark
  • Gatsby: Works with remark plugins
  • VS Code: Preview works perfectly

Advanced Features

  • Automatic Padding: Ensures consistent column counts across rows
  • Empty Cell Handling: Properly handles missing data
  • Special Characters: Preserves most characters (escape pipes with backslash if needed)
  • Multi-line Support: Use HTML <br> tags for line breaks within cells

MediaWiki Table Syntax

Supports standard MediaWiki table markup:

  • {|: Table opening with optional attributes
  • ! Header: Exclamation mark for header cells (separated by !!)
  • |-: Row separator
  • | Data: Pipe for data cells (separated by ||)
  • |}: Table closing

Privacy & Security

All conversions happen locally in your browser. Your MediaWiki data is never uploaded to any server, ensuring complete privacy and security.