"Real" Markdown Integration

193 views
Skip to first unread message

Christopher Mann

unread,
Nov 28, 2015, 5:41:54 AM11/28/15
to tiddly...@googlegroups.com

Hi, 

I see a couple of hurdles to native Markdown integration.

  1. The links are not processed natively by the Wiki Engine.
    • Neither [links[]] nor [backlinks[]] can work
    • Sometimes, treating the internal links as external links can create strange behavior
    • The #SomeTiddler solution is actually a work-around
  2. The .tid files cannot be natively .md, and that is too bad.
    • With .md files, we could have ubiquietous Tiddler and Markdow files
    • The title: TiddlerTitle comes into default Markdown as litteral text. MultiMarkdown could probably parse the header lines as-is.
    • If we could just enclose the title: abc etc. with a HTML comment <!-- \n --> then all would be good.
  3. It would be neat to have TiddlyWiki as a super-set on Markdown. 
    • If the links could have the extension .md in them I could browse the pages repository without TiddlyWiki too. The problem is that filesystem changes are not pushed on NodeJS implementations.
    • There are a couple of issues with the implementation of Markdown itself in Javascript that http://www.tagspaces.org/ seems to have resolved. My main issue is with tables.
    • Pandoc http://pandoc.org seems to have resolved many of the questions around the inadequacies of Markdown for wikis here http://pandoc.org/README.html#pandocs-markdown

Christopher
http://tiddlywiki.howwownow.com

Christopher Mann

unread,
Nov 28, 2015, 6:18:44 AM11/28/15
to tiddly...@googlegroups.com

Oh, yes, transclusion. I forgot to mention transclusion in Markdown. What would the implications of Marklusion be?

By the way, it seems I can hard-code my header sections for Markdown tiddlers with a first line as <!-- vim :set ts=4 sw=4 sts=4 et :

My README is now

<!-- vim :set ts=4 sw=4 sts=4 et :
created: 20151128000000000
creator: Christopher Mann <chris...@mann.fr>
description: TiddlyWiki How?Wow!Now Goodies plugin README. Goodies is a collection of utility tiddlers for my personal use.
tags: $:/plugins/editor/plugin
title: $:/plugins/howwownow/goodies/README
type: text/vnd.tiddlywiki
-->

# Goodies Plugin from HowWowNow

Goodies is a collection of utility tiddlers[...]

Christopher
http://tiddlywiki.howwownow.com

Christopher Mann

unread,
Nov 28, 2015, 6:21:34 AM11/28/15
to tiddly...@googlegroups.com

Sorry, please read type: text/x-markdown instead of type: text/vnd.tiddlywiki in my previous email.

Christopher
http://tiddlywiki.howwownow.com 



Le 28 nov. 2015 à 12:18, Christopher Mann <chris...@mann.fr> a écrit :

Oh, yes, transclusion. I forgot to mention transclusion in Markdown. What would the implications of Marklusion be?

By the way, it seems I can hard-code my header sections for Markdown tiddlers with a first line as <!-- vim :set ts=4 sw=4 sts=4 et :

My README is now

<!-- vim :set ts=4 sw=4 sts=4 et :
created: 20151128000000000
creator: Christopher Mann <chris...@mann.fr>
description: TiddlyWiki How?Wow!Now Goodies plugin README. Goodies is a collection of utility tiddlers for my personal use.

tags: $:/plugins/editor/plugin
title: $:/plugins/howwownow/goodies/README
type: text/x-markdown
-->

# Goodies Plugin from HowWowNow

Goodies is a collection of utility tiddlers[...]

BJ

unread,
Nov 28, 2015, 9:32:49 AM11/28/15
to TiddlyWikiDev
Hi Christopher,

there is a plugin for the marked version of markdown here

http://bjtools.tiddlyspot.com which does tables and html.

I have experimented with markdown and transclusion and other  tw5 widgets within markdown. One problem is that there are rules as to where html can be used in markdown (at least for the block mode type html tags), so sometime tiddlywiki widgets will not work (if they are considered as html tags).

all the best
BJ

Tobias Beer

unread,
Nov 28, 2015, 3:08:07 PM11/28/15
to tiddly...@googlegroups.com
I imagine one approach would be two step parsing...
  1. parse the document for a constrained set of parser rules (that do not represent valid markdown but are important in a wiki context)
  2. parse markdown with links and transclusions (recursion?) properly brought to life
So, looked at with pure Markdown rendering would merely indicate that there is an expectation for transclusion and wikilinks to be handled... which under TiddlyWiki either in node or the browser are handled appropriately.
 
Best wishes,

Tobias.

BJ

unread,
Dec 2, 2015, 2:05:26 PM12/2/15
to TiddlyWikiDev
I have an experimental extension to markdown and marked that enables tw macros and transclusion:

http://extendedmarkdown.tiddlyspot.com/

All the best
BJ
Reply all
Reply to author
Forward
0 new messages