Eclipse Markdown

Posted on  by admin

Markdown Editor plugin for Eclipse

Drag and drop this button into a running Eclipse Indigo workspace to install Markdown Text Editor via the Eclipse Marketplace:

Oxygen provides a built-in Markdown editor that allows you to convert Markdown syntax to HTML or DITA and it includes a preview panel to help you visualize the final output. Aside from the plain. Markdown Semantic is an Eclipse plug-in for displaying and editing Markdown (.md) files. It is based on two components: Flexmark - to parse, format and render Markdown; SemanticUI - to apply style to the rendered HTML; It also uses highlight.js to format rendered source code.

To install, use Eclipse's Software Updates mechanism (Help > Install New Software) with the URL:

You may wish to check the Eclipse Marketplace entry for latest version information.

Alternatively, you can download the required files - which are just plugins/winterwell.markdown_0.2.3.jar and features/markdown.editor.feature_0.2.3.jar - and copy them intothe plugins and features directories in your Eclipse installation.


Once installed, the plugin provides you with a new editor for .md files.You will probably also want to set it as the editor for .txt files.To do this, go to Preferences->Editor->File Associations. Selectthe file type '*.txt' and add the Markdown Editor as the default editor. You can also use it for other files by right-clicking on the fileand going through the 'open with' sub menu.


  • Document outline. A fantastic feature that lets you see, navigate and edit the structure of text documents.
  • Markdown syntax highlighting
  • Export to html. This is accessed via the File menu.
  • Preview window. Accessed via Window->Show view->other->Markdown

Source Code

The source code is hosted on github: Eclipse-Markdown-Editor-Plugin. You can fork it (and please do send enhancements back).

The Java source code is also included in the download.


This is a personal project. Please report any bugs to .

Copyright and License

This is released as open-source under the Eclipse Public License. Developed by Daniel Winterstein and maintained with help from Paul Verest and with contributions from various people (thank you). This code is copyright (c) Winterwell Associates Ltd, 2008-2013 and ThinkTank Mathematics Ltd, 2007 except where otherwise stated.

This code comes with no warranty or support.

Eclipse it is an open source community project aimed at providing a universal development platform. The Eclipse project is best known for its multiplatform integrated development environment (IDE). Arch Linux packages (and this guide) are specifically related to the IDE.

Eclipse IDE is largely written in Java, but can be used to develop applications in many languages, including Java, C / C++, PHP, Perl, Rust and Python. The IDE can also provide subversion support and task management.


Install one of the following packages:

  • eclipse-jeeAUR for Java EE Developers
  • eclipse-javaAUR or eclipse-java-binAUR for Java Developers
  • eclipse-cppAUR for C/C++ Developers
  • eclipse-phpAUR for PHP Developers
  • eclipse-javascriptAUR for JavaScript and Web Developers
  • eclipse-rustAUR for Rust Developers

You cannot install several of them at the same time as they conflict, see FS#45577: choose the package above which meets your needs immediately and add support for the additional languages you need through #Plugins. If space is at a premium, install eclipse-java-binAUR instead of eclipse-javaAUR as the latter downloads many different versions of Eclipse all at once before installing.



Many plugins are easily installed using pacman (look Eclipse plugin package guidelines for more information). This will also keep them updated. Alternatively, you can choose the Eclipse Marketplace or the internal plugin manager.

Add the default update site

Be sure to verify that the default update site for your version of Eclipse is configured so that plug-in dependencies can be installed automatically. The most current version of Eclipse is Photon and the default update site is: Go to Help > Install New Software > Add, fill in the name to easily identify the update site later - for example, Photon Software Repository - and fill in the location with the URL.

Eclipse Marketplace

Note: make sure you have followed the Add the default update site section.

To use the Eclipse Marketplace, install it first: go to Help > Install new software > Switch to the default update site > General Purpose Tools > Marketplace Client. Restart Eclipse and it will be available in Help > Eclipse Marketplace.

Plugin manager

Note: make sure you have followed the Add the default update site section.

Use Eclipse's plugin manager to download and install plugins from their original repositories: in this case you have to find the needed repository in the plugin's website, then go to Help > Install New Software..., enter the repository in the Work with field, select the plugin to install from the list below and follow the instructions.

  • If you install plugins with Eclipse's plugin manager, you are advised to launch Eclipse as root: this way the plugins will be installed in /usr/lib/eclipse/plugins/; if you installed them as normal user, they would be stored in a version-dependent folder inside ~/.eclipse/, and, after upgrading Eclipse, they would not be recognized any longer.
  • Do not use Eclipse as root for your everyday work.

Updates via plugin manager

Run Eclipse and select Help > Check for Updates. If you have installed them as root as advised in the section above, you have to run Eclipse as root.

For plugins to be updated, you should check to have their update repositories enabled in Window > Preferences > Install/Update > Available Software Sites: you can find each plugin's repository(es) on the respective project website. To add, edit, remove... repositories just use the buttons on the right of the Available Software Sites panel. For Eclipse 4.5 (Mars), check you have enabled this repository:

To receive update notifications, go to Window > Preferences > Install/Update > Automatic Updates. If you want to receive notifications for plugins installed as root, you should run Eclipse as root, go to Window > Preferences > Install/Update > Available Software Sites, select the repositories related to the installed plugins and Export them, then run Eclipse as normal user and Import them in the same panel.

List of plugins

  • AVR — AVR microcontroller plugin. eclipse-avrAUR
  • Aptana — HTML5/CSS3/JavaScript/Ruby/Rails/PHP/Pydev/Django support. Also available as standalone application. aptana-studioAUR
  • IvyDE — IvyDE dependency Manager. eclipse-ivydeAUR[broken link: package not found]
  • Markdown — Markdown editor plugin for Eclipse. eclipse-markdownAUR
  • PyDev — Python support. eclipse-pydevAUR
  • Subclipse — Subversion support. eclipse-subclipseAUR
  • Subversive — Alternative Subversion support. eclipse-subversiveAUR


  • TestNG — TestNG support.

See Full List On eclipse-testngAUR
  • TeXlipse — LaTeX support. eclipse-texlipseAUR
  • Checkstyle — Eclipse Checkstyle support. eclipse-checkstyleAUR

Enable javadoc integration

Want to see API entries when hovering the mouse pointer over standard Java methods?

Eclipse Markdown Definition

Online version

If you have constant Internet access on your machine, you can use the on-line documentation:

  1. Go to Window > Preferences, then go to Java > Installed JREs.
  2. There should be one named 'java' with the type 'Standard VM'. Select this and click Edit.
  3. Select the /usr/lib/jvm/java-8-openjdka/jre/lib/rt.jar item under 'JRE system libraries:', then click Javadoc Location....
  4. Enter '' in the 'Javadoc location path:' text field.

Offline version

You can store the documentation locally by installing the openjdk8-doc package. Eclipse may be able to find the javadocs automatically. If that does not work, set Javadoc location for rt.jar to file:/usr/share/doc/java8-openjdk/api.


Ctrl+X closes Eclipse

Part of this bug. Just look in ~/workspace/.metadata/.plugins/org.eclipse.e4.workbench/workbench.xmi and delete the wrong Ctrl+X combination. Usually it is the first one.

Dark theme

Eclipse supplies a Dark theme which can be enabled in Window > Preferences > General > Appearance and selecting the Dark theme.

The dark theme uses its own colours rather than the GTK theme colours, if you prefer it to fully respect GTK colour settings, then remove or move to backup sub folder all of the .css files from /usr/lib/eclipse/plugins/org.eclipse.ui.themes_version/css/, replacing the version with the appropriate version number.

Change Default Window Title Font Size

You cannot change the window title font size using the Eclipse preferences, you must edit the actual theme .css files. These are located under /usr/lib/eclipse/plugins/org.eclipse.themes_version/css/ directory, where version is the actual theme version number.

Eclipse Markdown

Use an text editor to edit the appropriate file, e.g. e4_default_gtk.css if you are using the 'GTK theme'.

In this file, search for .MPartStack, and change the font-size to your desired size:

Note: This needs to be redone whenever eclipse is upgraded.

Disable GTK 3

If the SWT GTK 3 UI gets buggy or unusable, it can be disabled by prepending SWT_GTK3=0environment variable when starting Eclipse:

Another option to achieve the same effect is to add the following to Eclipse's ini file, before--launcher.appendVmargs:


Eclipse is not compatible with freshplayerpluginAUR. See

Eclipse 4.6 may not open the marketplace properly

See this bug. You can take following two steps to fix it:


Show in System Explorer does not work

See this guide. Go to Window > Preferences > General > Workspace and change the command launching system explorer. As Xfce user you may like to change it to thunar ${selected_resource_uri} to open the selected folder with thunar.

Display issues under Wayland

When running Eclipse on Wayland, you may encounter rendering issues such as slow response time to mouse events or chopped dialog windows (Bug report [1]). A possible workaround for this issue is to force Eclipse to run under XWayland.

With the superuser, open the file /usr/bin/eclipse and append this line before the exec line:

This will force the execution of Eclipse on XWayland.

See also

Retrieved from ''