Render Markdown formatted text

[anonymous]

I'd really like Trac to be able to handle ​Markdown formatted text. There is a python implementation of Markdown available ​here.

Thanks!

[petef]

I would love to see this. It would make such a difference to working with non-technical wiki authors.

[lianos]

I'd really dig this, too

[Shun-ichi Goto]

Very very easy solution is here.

## mkdown.py -- easy markdown formatter without trac links.
rom markdown import markdown

# as for wiki-macro
def execute(hdf, txt, env):
    return markdown(txt.encode('utf-8'))

This macro does not handle trac links at all but it might be possible using extension mechanism of current Markdown (1.6).

[turing]

but it might be possible using extension mechanism of current Markdown (1.6).

A complete solution would be so fantastic, I'm weeping with anticipation.

[brian@…]

I wrote this today. It's a little buggy, but seems usable. Things like [Bob's patch]([40]) or [camel case]: CamelCase work. <CamelCase> works but shows the whole url.

"""Trac plugin for Markdown Syntax (with links)

Everything markdown-ed as a link target is run through Trac's wiki
formatter to get a substitute url.

Tested with Trac 0.8.1 and python-markdown 1.4 on Debian GNU/Linux.

Brian Jaress
2007-01-04
"""

from re import sub, compile, search, I
from markdown import markdown
from trac.WikiFormatter import wiki_to_oneliner

#links, autolinks, and reference-style links
LINK = compile(
    r'(\]\()([^) ]+)([^)]*\))|(<)([^>]+)(>)|(\n\[[^]]+\]: *)([^ \n]+)(.*\n)'
)

HREF = compile(r'href=[\'"]?([^\'" ]*)')

def execute(hdf, txt, env):
    abs = env.abs_href.base
    abs = abs[:len(abs) - len(env.href.base)]
    def convert(m):
        pre, target, suf = filter(None, m.groups())
        url = search(
                HREF,
                wiki_to_oneliner(target, hdf, env, env.get_db_cnx()),
                I).groups()[0]
        #Trac creates relative links, which markdown won't touch inside
        # <autolinks> because they look like HTML
        if pre == '<' and url != target:
            pre += abs
        return pre + str(url) + suf

    return markdown(sub(LINK, convert, txt))

[anonymous]

+ for markdown support

However the only way Markdown is really going to be adopted this way is if we can use it as the default text markup. As soon as we need # etc and to close then Markdown will not get used.

So we need it to be in trac.ini to support default without //!/# / tricks.

[Yura Ivanov]

There is implementation of markdown in pure js: ​http://www.attacklab.net/showdown-gui.html And another js improvement of it (with syntax highlighting): ​http://softwaremaniacs.org/playground/showdown-highlight/

[anonymous]

For the trac version I have this needs a tiny edit:

from trac.wiki.formatter import wiki_to_oneliner 

[fwolf.aide+trac@…]

I'd like to see we can write in trac using Markdown syntax too...

And also, here an Markdown Extra which extended original Markdown

​http://michelf.com/projects/php-markdown/extra/

[killer_storm]

Markdown plugin for Trac 0.11 (ebta)

[killer_storm]

i've adapted version by brian for Trac version 0.11.

• copy file (Markdown.py from attachments) into yourproject/plugins.
• install markdown (e.g. apt-get install python-markdown on Debian/Ubuntu).
• restart webserver and enjoy

you can use it as wiki processor:

   {{{
   #!Markdown
   
   markdown text goes here
   =======================
   ...
   }}}

(notice the capital letter M)

[knittl]

if you get this error:

Trac detected an internal error:

AttributeError: 'unicode' object has no attribute 'parent'

you have to get the latest python-markdown version with unicode support from ​http://www.freewisdom.org/projects/python-markdown/Releases and install it on your (most probably debian) system with

python setup.py install

after a server restart you should be able to use markdown

[antony]

To add support for ​Markdown Extra, change the line

return markdown(sub(LINK, convert, txt))

to read

return markdown(sub(LINK, convert, txt), ['extra'])

To allow escaping of links using an exclamation mark, eg:

[Ticket](!#1)

change the line

LINK = compile(
    r'(\]\()([^) ]+)([^)]*\))|(<)([^>]+)(>)|(\n\[[^]]+\]: *)([^ \n]+)(.*\n)'
)

to read

LINK = compile(
    r'(\]\()([^) !]+)([^)]*\))|(<)([^>]+)(>)|(\n\[[^]]+\]: *)([^ \n]+)(.*\n)'
)

in the attacked Markdown.py

[canton]

Bug fixes

[anonymous]

Added Markdown.2.py with the following bug fixes to killer_storm's code:

• Allowed escaping of Trac links, so eg [Link](!#1) will become [Link](#1) instead of [Link](!/ticket/1)
• Fixed a bug where a markdown link containing a target location that Trac doesn't think is a valid link would cause an Internal Error
• <CamelCase> no longer shows the whole URL

[anonymous]

There seems to be a trac-hacks page for this now: MarkdownMacro.

[anonymous]

In Python 2.6, Trac 0.12

need to change

            href_match = search(
                    HREF,
                    out.getvalue(),
                    I)

to

            href_match = search(
                    HREF,
                    out.getvalue())

and

    HREF = compile(r'href=[\'"]?([^\'" ]*)')

to

    HREF = compile(r'href=[\'"]?([^\'" ]*)', I)

[Ryan J Ollos]

MarkdownMacro has been patched. Please try out the latest source, version 0.11.2.

[Ryan J Ollos]

Re-opening to consider implementing some of the changes in Markdown.2.py​.

[Sander.Maijers@…]

Today I fetched the latest SVN version of MarkdownMacro, installed it on Trac 1.0.1. My test shows that fenced code blocks are not being parsed, while the Markdown library supports this syntax: ​http://pythonhosted.org/Markdown/extensions/fenced_code_blocks.html

[Ryan J Ollos]

I'm not sure when I will have time to work on this, but I'd gladly accept a patch.

[Cinc-th]

The macro now uses markdown extensions to render TracLinks, WikiMacros, WikiProcessors, code fences with highlighting and more.

Use current tunk (r18416 or later).