skip to navigation
skip to content

Not Logged In

tiddlywebplugins.markdown 1.2.10

Markdown rendering for TiddlyWeb

Latest Version: 1.3.0

# Intro

A [TiddlyWeb] plugin to render markdown
syntax wikitext to HTML using the
[Python Markdown] library.

The source repository is available
[on GitHub]

# Features

If `markdown.wiki_link_base` is set in
[instance] config, then
TiddlyWeb oriented features are turned on (see below),
otherwise the text is treated as straight Markdown.

By default HTML in user input is escaped. If different behavior
is desired set `markdown.safe_mode` in config to one of the values
described in the [Python-Markdown
"replace", "escape", "remove" of `False`.

Additional Markdown extensions can be activated via the `markdown.extensions`
configuration settings, which is a tuple of two items: A list of extension names
and a dictionary with configuration settings.

By default some extensions are included:

* `fenced_code`:
* `def_list`:
* `foootnotes`:
* `headerid`:

The TiddlyWeb features add the following:

* `wikilinks`: CamelCase
* `freelinks`: [[some page]]
* `labeled freelinks`: [[label|some page]]
* `transclusion`: see below

Wikilinks and freelinks will be prefixed by `wiki_link_base`.
Set it to '' (emptry string) to activate the features without any prefix.

Transclusion uses the following syntax:

{{tiddler title}}

That will include tiddler with the given title from the
current context (recipe or bag) of the transcluding tiddler.

Links and transclusion can be augmented with `@target` syntax:

* `@target`
* `CamelCase@target`
* `[[some page]]@target`
* `[[label|some page]]@target`
* `{{tiddler title}}@target`

`target` is resolved via three different configuration settings:

* `markdown.interlinker` names a function which returns a link
to whatever might be considered a target of some kind. It's
arguments are a WSGI environ and a string representing the
target. It returns a URI for the target, without the title
of the tiddler.

* `markdown.target_resolver` names a function which determines
the tiddler object that is to be transcluded. It's arguments
are a WSGI environ, a string representing the context from
which a tiddler is being transcluded and a tiddler object.
That tiddler object is modified in place to add the bag in
which it can be found.

* `markdown.transclude_url` names a function which returns a
link to a tiddler in a target context. It's arguments are a
WSGI environ and a tiddler. It returns a URI for the tiddler
that has been transcluded. This is useful for augmenting the
output to include a link to the transcluded tiddler.

If the desired target contains spaces, wrap the target in [[ ]], for

[[my page]]@[[my bag]]

To use this renderer on Tiddlers which have a type of
`text/x-markdown` adjust
to include:

'wikitext.type_render_map' :{
'text/x-markdown': 'tiddlywebplugins.markdown'

If you want all tiddlers with no type to be rendered as markdown,
then set

'wikitext.default_renderer': 'tiddlywebplugins.markdown'

# Installation

Available from [PyPi]
install with [pip]

pip install -U tiddlywebplugins.markdown

# Other

Copyright 2009-2014 Chris Dent <>

Licensed under the same BSD license as TiddlyWeb  
File Type Py Version Uploaded on Size
tiddlywebplugins.markdown-1.2.10.tar.gz (md5) Source 2014-04-22 26KB
  • Downloads (All Versions):
  • 69 downloads in the last day
  • 346 downloads in the last week
  • 1838 downloads in the last month