HTML omitted from markdown

Q & A - getting started with Tinderbox
1

Hey everyone, I’m adding HTML to some notes but it’s being stripped from my HTML preview/export. Is there something special I can do to make it work or is this not allowed?

2

Do you have a file showing the problem? There’s not much to go on above.

3

@mwra I’ve attached a simple example. I’ve added a unordered list to the Test Note text and if you look at preview and export, it’s not present, instead replaced with a <!-- raw HTML omitted -→ . Thanks!
Markdown Test.tbx (95.7 KB)

4

Others here are more expert with Markdown than myself, but I’m confused to why you’re using an HTML list when just starting a line with an asterisk, like so:

* Test
*Another test

tells Markdown to output HTML like so:

<ul>
<li>Test</li>
<li>Another test</li>
</ul>

The Markdown prototype you have in your file uses the newer CommonMark flavour of Markdown so perhaps it doesn’t allow mixed inline HTML. Certainly, I see little point using HTML code to enter styling for which Markdown already offers a Markdown-based method. Ideally, pick one method or the other.

A quick google suggests ‘raw HTML’ is turned off by default so if you need to mix you’ll need to look-up and apply the CommonMark preference-altering command line for that. Have you tried using the ‘Markdown’ flavour ouriginally bundled with Tinderbox. See here for how to swap the flavours over.

@satikusala - any ideas on this?

5

Ha, my brain must have not been working when I started this. Instead I adjusted my code note to produce markdown instead of raw HTML:

$MyNotes=collect_if(children(/References), $IsIndex, $Name);

$MyLinks=;

$MyNotes.each(X) {
    $MyLinks=$MyLinks + ("- ["+ X +"]("+ $HTMLExportPath(X) +")")
};

$Text=$MyLinks.format("\n");

I think for some reason I thought Tinderbox was doing something magical with the ziplinks when producing hyperlinks but I realize now it was just standard markdown.

Thanks!

6

There is no such thing as a ziplink - that will simply confuse you further. The ‘ziplink’ method sic of link creation creates normal Tinderbox text links. One a link is created, Tinderbox has zero knowledge of the method of the links creration.

So, I repeat “There is no such thing as a ziplink”. That incorrect assumption seems to be causing no end of confusion. The actual types of link in Tinderbox (as opposed to ‘link type’) are discussed here.

7

Sorry, my last was a bit rushed as going into a meeting. My comments weren’t meant critically, but simply to help give context that helps unpack things like the ‘ziplink’ method which, by packing an otherwise number of discrete tasks into one task, can give a slightly black box feel. Under the hood, it’s all things one can do ‘manually’ in the app. The Ziplink method is just an easy way of making Tinderbox text links. It is works best for keyboard centric folk and you can type all the sub-task input in in one go (once you learn the format.

HTH :slight_smile:

8

Absolutely! Didn’t take it critically. Good to know that ziplinks is a method, not a feature.

Thanks again for fast response and help.

1 Like