Differences

This shows you the differences between two versions of the page.

--- res:plugins:parsedown [2026/05/01 18:06] – [Links] fraenkiman
+++ res:plugins:parsedown [2026/05/01 21:18] (current) – [Description] fraenkiman
@@ Line 12: / Line 12: @@
   * Super Fast
-  * Extensible
+  * Extensible (For example, using [[https://github.com/BenjaminHoegh/ParsedownExtended|ParsedownExtended]] by Benjamin Høegh)
 Why Parsedown? It's faster, more consistent and is being actively developed.
@@ Line 18: / Line 18: @@
 [[https://parsedown.org/|Parsedown]] passes most [[https://parsedown.org/tests/|CommonMark tests]]. The tests that fail are more unusual cases.
 However, as CommonMark continues to evolve, compliance should improve.
+===== Requirements =====
+You need:
+  * a working ≥ [[en:doc:basic:upgrade|FlatPress 1.5.1 Stringendo]] installation
+  * PHP **7.2 to 8.5**
+  * the plugin files from [[res:plugins:parsedown#download|this package]]
 ===== How FlatPress uses the plugin =====
@@ Line 45: / Line 54: @@
   * ''libxml_use_internal_errors()''
-If these PHP features are missing, the plugin falls back to plain Parsedown. In that fallback mode, the "Parsedown Extra syntax" section below is not available. For example, ''# Heading {#id}'' will be rendered as a heading containing the literal text ''{#id}'' instead of creating an HTML ''id'' attribute.
+If these PHP features are missing, the plugin falls back to plain Parsedown. In that fallback mode, the "[[res:plugins:parsedown#parsedown_extra_syntax|Parsedown Extra syntax]]" section below is not available. For example, ''# Heading {#id}'' will be rendered as a heading containing the literal text ''{#id}'' instead of creating an HTML ''id'' attribute.
@@ Line 179: / Line 188: @@
 ==== Tables with preformatted cells ====
+Alignment markers:
+'':—'' left aligned, ''—:'' right aligned, '':—:'' centred
 <code>| One        | Two  |
 | :--        | :--  |
@@ Line 242: / Line 253: @@
 __double underlines__
-Lord*God*sacrament
+Lord*God*Sacrament
-\*This text is enclosed by asterisks.\*
+This is ~~deleted text~~.
+\*This text is surrounded by literal asterisks.\*
 *italics*, **bold** and ***bold italics*** or
@@ Line 326: / Line 339: @@
-===== License =====
+===== Parsedown Extra syntax =====
-[[https://github.com/erusev/parsedown/blob/master/LICENSE.txt|MIT]]
+The syntax in this section works only when Parsedown Extra is active. See "[[res:plugins:parsedown#parsedown_extra_availability|Parsedown Extra availability]]" above.
+==== Special attributes for headers ====
+<code>## Header with ID {#my-header}
-===== Requirements =====
+## Header with class {.important}
+## Header with ID and class {#my-header .important}</code>
+Then link to the header with:
+<code>[Jump to the header](#my-header)</code>
+==== Special attributes for links and images ====
+<code>[FlatPress](https://www.flatpress.org/){#flatpress-link .button}
+![Logo](https://www.flatpress.org/fp-interface/themes/official-site/imgs/fp-logo.png){#fp-logo .logo}</code>
+This bundled Parsedown Extra implementation supports ''#id'' and ''.class'' tokens. It does not process arbitrary attributes such as ''lang=de''.
+==== Footnotes ====
+<code>Text with a footnote.[^1]
+[^1]: This is the footnote text.</code>
+Footnotes are collected at the end of the parsed text.
+==== Definition lists ====
+<code>Apple
+: Pomaceous fruit
+: Technology company
+Orange
+: Citrus fruit</code>
+==== Abbreviations ====
+<code>*[HTML]: Hyper Text Markup Language
+*[W3C]: World Wide Web Consortium
+The HTML specification is maintained by the W3C.</code>
+Abbreviation definitions are removed from the output. Matching terms are rendered as ''<abbr>'' elements.
+===== License =====
+[[https://github.com/erusev/parsedown/blob/master/LICENSE.txt|MIT]]
-You need:
-  * a working ≥ [[en:doc:basic:upgrade|FlatPress 1.5.1 Stringendo]] installation
-  * PHP **7.2 to 8.5**
-  * the plugin files from [[res:plugins:parsedown#download|this package]]
 ===== Download =====
@@ Line 344: / Line 396: @@
 == 2026-05-01: Version 1.1.3 ==
   * Corrected incorrect documentation (anchor links)
+  * Documentation expanded to include the Parsedown Extra syntax
 == 2026-04-23: Version 1.1.2 ==
   * Comments continue to be stored in a sanitized format. Only safe autolinks are restored immediately before parsing.