Skip to content
Text importer for loading Markdown text into Scribus files.
C GAP C++ Other
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


Text importer for loading simple Markdown text into Scribus files.

It must at least support:

  • headings
  • italics
  • bold
  • lists
  • rendering links in a printer friendly way
  • blockquotes as intended paragraph

All information concerning this plugin's code is in src/


Clone the scribus-plugin-gettext-markdown repository and put – or symlink – the src directory into scribus/plugins/gettext/ as markdown. Then add


to CMakeList file in scribus/plugins/gettext/.


This specification follows the structure of (John Gruber's Markdown Syntax]( specification.



For a first step we will try to implement the minimal feature set that allows to meaningfully use Markdown for a redaction system in a workflow that uses (also) Scribus.

The plugin will be for the 1.5.0svn version of Scribus.

If they don't exist we will create "standard" styles. In the future we could define a per document (or per frame) way to match to existing styles.

Inline HTML

HTML tags will be ignored for now.

In the future, only tags that are clearly useful in a Scribus related workflow will be considered.

Automatic escaping for special characters

Named escaped characters will be converted to the correct caracter.

  • & → &
  • &lt; → <
  • &gt; → >

###Block Elements

Paragraphs and Line Breaks

Paragraph are separated by consecutive empty lines

Line break is supported with two spaces at the end of the line (we will need two paragraph styles, one for the first paragraph and one for the following ones)


We support the use of "#" to mark headers, up to 6 levels


Paragraphs starting with a ">" are marked as blockquote and indented (by using a specific paragraph style).

In a first version, blocquote cannot contain other paragraph formatting (headings, ...)


We want to support the following formats for lists:

* Red
* Green
* Blue

- Red
- Green
- Blue

1. Red
2. Green
3. Blue

For numerated lists, the number is ignored and a counter is used instead.

Code Blocks

Paragraphs intended by at least four spaces or one tab are considered code blocks (using a specific paragraph style).

Horizontal Rules


Span Elements


Links written as [This link]( will be converted to This link (

No "real" link is created as long Scribus does not "really" support them.


Single asterisks and underscores produce italics (emphasis) and double asterisks or underscores bold (strong).

Litteral asterisks and underscore must be prefixed by a backslash.


The forward quote starts a character "code block".


Images are ignore for now.


Automatic Links

Automatic links are reformatted by removing the starting and end sign (<, >).

Backslash Escapes

We will support the markdown escaping.

Interesting reads

You can’t perform that action at this time.