Convert ORG to Wiki
Max file size 100mb.
ORG vs MediaWiki Format Comparison
| Aspect | ORG (Source Format) | Wiki (Target Format) |
|---|---|---|
| Format Overview |
ORG
Emacs Org-mode
Plain text markup format created for Emacs in 2003. Designed for note-taking, task management, project planning, and literate programming. Features hierarchical structure with collapsible sections, TODO states, scheduling, and code execution. Emacs Native Literate Programming |
MediaWiki
Wiki Markup Language
Markup language created for MediaWiki software that powers Wikipedia. Designed for collaborative web-based content creation with support for templates, categories, internal links, and structured content. The standard for wiki-style documentation. Wikipedia Standard Collaborative Editing |
| Technical Specifications |
Structure: Hierarchical outline with * headers
Encoding: UTF-8 Format: Plain text with markup Processor: Emacs Org-mode, Pandoc Extensions: .org |
Structure: Flat text with wiki markup
Encoding: UTF-8 Format: MediaWiki markup Processor: MediaWiki, Pandoc Extensions: .wiki, .mediawiki, .mw |
| Syntax Examples |
Org-mode syntax: #+TITLE: Article Title * Introduction This is *bold* and /italic/ text. ** History The project started in [[https://example.com][2003]]. - First item - Second item | Name | Value | |-------+-------| | Alpha | 100 | | Beta | 200 | |
MediaWiki syntax: = Article Title =
== Introduction ==
This is '''bold''' and ''italic'' text.
=== History ===
The project started in [https://example.com 2003].
* First item
* Second item
{| class="wikitable"
|-
! Name !! Value
|-
| Alpha || 100
|-
| Beta || 200
|}
|
| Content Support |
|
|
| Advantages |
|
|
| Disadvantages |
|
|
| Common Uses |
|
|
| Best For |
|
|
| Version History |
Introduced: 2003 (Carsten Dominik)
Current Version: 9.6+ (2024) Status: Active development Primary Tool: GNU Emacs |
Introduced: 2002 (MediaWiki 1.0)
Current Version: MediaWiki 1.40+ (2024) Status: Active development Primary Platform: Wikipedia, wikis |
| Software Support |
Emacs: Native support (Org-mode)
Vim/Neovim: org.nvim, vim-orgmode VS Code: Org Mode extension Other: Logseq, Obsidian (plugins) |
MediaWiki: Native platform
Wikipedia: Primary use case Pandoc: Full support Editors: Visual Editor, WikiEd |
Why Convert ORG to Wiki?
Converting Org-mode documents to MediaWiki format is essential when you want to publish content on Wikipedia, corporate wikis, or any MediaWiki-powered platform. While Org-mode is excellent for personal knowledge management, MediaWiki markup is the standard for collaborative web-based documentation.
MediaWiki powers some of the world's largest knowledge repositories, including Wikipedia with its millions of articles. Converting your Org-mode research, documentation, or notes to wiki format allows you to contribute to these communities or publish on your organization's wiki.
The conversion is particularly valuable for researchers and technical writers who draft content in Org-mode's powerful environment but need to publish in wiki format. Your structured notes become ready for collaborative editing and community contribution.
Wiki format also provides features like internal page linking, categories, and templates that enable rich interconnected documentation. Converting from Org-mode preserves your content structure while gaining access to wiki-specific organizational features.
Key Benefits of Converting ORG to Wiki:
- Wikipedia Ready: Contribute to Wikipedia articles
- Corporate Wikis: Publish on enterprise wiki platforms
- Collaborative Editing: Enable team contributions
- Internal Linking: Create interconnected pages
- Categories: Organize content hierarchically
- Templates: Use reusable content blocks
- Version History: Built-in change tracking
Practical Examples
Example 1: Documentation Article
Input ORG file (article.org):
#+TITLE: Python Programming Language
* Overview
*Python* is a high-level programming language created by
[[https://en.wikipedia.org/wiki/Guido_van_Rossum][Guido van Rossum]].
* Features
- Easy to learn
- Interpreted language
- Dynamic typing
* Code Example
#+BEGIN_SRC python
print("Hello, World!")
#+END_SRC
* See Also
- [[file:java.org][Java]]
- [[file:ruby.org][Ruby]]
Output Wiki file (article.wiki):
= Python Programming Language =
== Overview ==
'''Python''' is a high-level programming language created by
[https://en.wikipedia.org/wiki/Guido_van_Rossum Guido van Rossum].
== Features ==
* Easy to learn
* Interpreted language
* Dynamic typing
== Code Example ==
<syntaxhighlight lang="python">
print("Hello, World!")
</syntaxhighlight>
== See Also ==
* [[Java]]
* [[Ruby]]
Example 2: Data Table Conversion
Input ORG file (comparison.org):
* Programming Language Comparison | Language | Year | Typing | Paradigm | |----------+------+------------+-------------| | Python | 1991 | Dynamic | Multi | | Java | 1995 | Static | OOP | | Rust | 2010 | Static | Multi | | Go | 2009 | Static | Concurrent | ** Notes This comparison focuses on /mainstream/ languages.
Output Wiki file (comparison.wiki):
== Programming Language Comparison ==
{| class="wikitable sortable"
|-
! Language !! Year !! Typing !! Paradigm
|-
| Python || 1991 || Dynamic || Multi
|-
| Java || 1995 || Static || OOP
|-
| Rust || 2010 || Static || Multi
|-
| Go || 2009 || Static || Concurrent
|}
=== Notes ===
This comparison focuses on ''mainstream'' languages.
Example 3: Reference Article
Input ORG file (reference.org):
* Emacs Text Editor Emacs is a family of text editors. ** History Created by Richard Stallman in 1976. ** Key Features 1. Extensible via Emacs Lisp 2. Self-documenting 3. Cross-platform #+BEGIN_QUOTE "Emacs is the extensible, customizable, self-documenting real-time display editor." — GNU Emacs Manual #+END_QUOTE ** External Links - [[https://www.gnu.org/software/emacs/][Official Website]] - [[https://github.com/emacs-mirror/emacs][Source Code]]
Output Wiki file (reference.wiki):
= Emacs Text Editor =
Emacs is a family of text editors.
== History ==
Created by Richard Stallman in 1976.
== Key Features ==
# Extensible via Emacs Lisp
# Self-documenting
# Cross-platform
{{Quote|Emacs is the extensible, customizable, self-documenting
real-time display editor.|GNU Emacs Manual}}
== External Links ==
* [https://www.gnu.org/software/emacs/ Official Website]
* [https://github.com/emacs-mirror/emacs Source Code]
[[Category:Text editors]]
Frequently Asked Questions (FAQ)
Q: What is MediaWiki markup?
A: MediaWiki markup is the formatting syntax used by MediaWiki software, which powers Wikipedia and thousands of other wikis. It uses special characters like = for headers, ''' for bold, and '' for italic. Internal links use [[Page Name]] syntax.
Q: Can I paste the output directly into Wikipedia?
A: Yes! The converted MediaWiki markup can be pasted directly into Wikipedia's edit window. However, Wikipedia has specific guidelines for content, citations, and notability that you should follow. The conversion handles formatting, but content review is still important.
Q: How are Org-mode links converted?
A: External links [[url][description]] become MediaWiki external links [url description]. File links to other .org files become internal wiki links [[Page Name]]. This enables seamless wiki-style navigation.
Q: What happens to code blocks?
A: Org-mode code blocks (#+BEGIN_SRC ... #+END_SRC) are converted to MediaWiki's <syntaxhighlight> tags with the appropriate language parameter. This preserves syntax highlighting when rendered on the wiki.
Q: Are tables converted properly?
A: Yes, Org-mode tables are converted to MediaWiki's wikitable format. The header row becomes table headers (!) and data rows use the || syntax. The "sortable" class is often added for interactive sorting.
Q: What about TODO items?
A: TODO states don't have a direct MediaWiki equivalent. They're converted to plain text or can be formatted as task lists using wiki templates like {{Done}} or {{Not done}} if available on your wiki.
Q: Can I convert wiki markup back to Org-mode?
A: Yes, using Pandoc: `pandoc -f mediawiki -t org input.wiki -o output.org`. This is useful for importing wiki content into your Org-mode workflow for local editing and enhancement.
Q: Does this work with other wiki platforms?
A: The output is MediaWiki-specific markup. Other wiki platforms like DokuWiki, Confluence, or Trac have different syntaxes. For those platforms, you may need additional conversion or manual adjustment.