1
0
mirror of https://github.com/Jermolene/TiddlyWiki5 synced 2024-11-30 05:19:57 +00:00
TiddlyWiki5/plugins/tiddlywiki/markdown
2024-09-12 19:31:13 +01:00
..
editor-operations Make markdown wikitext links readable (#8402) 2024-07-19 08:52:57 +01:00
EditorToolbar Add image toolbar dropdown to markdown plugin (#8459) 2024-07-31 13:38:25 +01:00
files Revamp markdown plugin (#6528) 2023-01-14 09:49:04 +00:00
images Parameterise core icons (#7413) 2023-05-06 12:08:46 +01:00
KeyboardShortcuts Revamp markdown plugin (#6528) 2023-01-14 09:49:04 +00:00
settings Add a settings page for markdown plugin (#8585) 2024-09-10 11:13:00 +01:00
config.multids Markdown Plugin: Default to recognising TiddlyWiki-format links 2023-02-24 09:51:45 +00:00
docs_type_markdown.tid Revamp markdown plugin (#6528) 2023-01-14 09:49:04 +00:00
markdown-it-katex.js Fix whitespace in all plugins for v5.3.6 (#8285) 2024-08-20 16:33:07 +01:00
markdown-it-tiddlywiki.js Update widget name policy (#7510) 2023-06-14 09:55:16 +01:00
new-markdown.tid Update PageControls buttons to use v5.3.2 syntax (#8579) 2024-09-10 12:00:13 +01:00
plugin.info Move contents of config tab to readme tab in markdown plugin (#8595) 2024-09-12 19:31:13 +01:00
readme.tid Move contents of config tab to readme tab in markdown plugin (#8595) 2024-09-12 19:31:13 +01:00
settings.tid Move contents of config tab to readme tab in markdown plugin (#8595) 2024-09-12 19:31:13 +01:00
styles.tid Apply proper color for target footnote background in markdown (#8492) 2024-08-07 12:07:22 +01:00
syntax.tid Revamp markdown plugin (#6528) 2023-01-14 09:49:04 +00:00
wrapper.js Fix whitespace in all plugins for v5.3.6 (#8285) 2024-08-20 16:33:07 +01:00

title: $:/plugins/tiddlywiki/markdown/readme

This plugin provides Markdown support via the [[markdown-it|https://github.com/markdown-it/markdown-it]] parser and its associated plugins:

* markdown-it-deflist
* markdown-it-footnote
* markdown-it-ins
* markdown-it-mark
* markdown-it-sub
* markdown-it-sup

!! Compatibility Notes

* <p>A tab character in Markdown has a size of four spaces. Configure the tab size of your code editor accordingly. For example, if you use <$text text="CodeMirror"/>, it is recommended that you set $:/config/codemirror/indentUnit and $:/config/codemirror/tabSize to `4` to avoid inconsistent indentations.</p>
* <p>HTML blocks are ultimately parsed by the <$text text=WikiText/> parser: //an opening tag followed by a blank line will activate block-level parsing for its content//. When working with tags designed to contain literal content, such as `<pre>` and `<style>` tags, refrain from adding blank lines after the opening tags.</p>
* <p>You must terminate a table with either a blank line or another block-level structure.</p>
* <p>`latex-parser` in $:/config/markdown/renderWikiTextPragma is no longer required and will be ignored.</p>
* <p>Config option `linkNewWindow` is removed.</p>

!! Extending the Parser

You can extend the parser by loading additional markdown-it plugins this way:

```js
var plugin1 = require(...);
var plugin2 = require(...);

var md = $tw.Wiki.parsers["text/markdown"].prototype.md;

md.use(plugin1)
  .use(plugin2, opts, ...);
```

! Plugin Configuration

<h2 style="margin-top:1.5em">~WikiText Pragma</h2>

The value of [[renderWikiTextPragma|$:/config/markdown/renderWikiTextPragma]] has been carefully tuned to properly integrate markdown with ~TiddlyWiki. Changing this setting may produce unexpected results, but the inclusion of the following parser rules should be fine:

; image
: embed images using ~TiddlyWiki's image syntax:

<p style="margin-left:1em">

```
[img[An explanatory tooltip|TiddlerTitle]]

[img width=23 class="tc-image" [https://tiddlywiki.com/fractalveg.jpg]]
```
</p>

; prettylink
: create links the ~TiddlyWiki way:

<p style="margin-left:1em">

```
[[TiddlerTitle]]

[[Displayed Link Title|Tiddler Title]]

[[TW5|https://tiddlywiki.com/]]
```
</p>

; prettyextlink
: create external links using the following syntax:

<p style="margin-left:1em">

```
[ext[Open file|index.html]]

[ext[Open file|../README.md]]
```
</p>

; wikilink
: auto-link ~CamelCase titles

; syslink
: auto-link system tiddlers

<h2 style="margin-top:1.5em">Typographical Replacements</h2>

When [[typographer|$:/config/markdown/typographer]] is enabled, markdown-it will provide these typographical replacements:

```
(c) (C)   → ©
(tm) (TM) → ™
(r) (R)   → ®
+-        → ±
...       → …
?....     → ?..
!....     → !..
?????     → ???
!!!!!     → !!!
,,        → ,
--        → &ndash;
---       → &mdash;
```