Wiki source code of Migrate Pages from Markdown 1.0 and 1.1
Last modified by Vincent Massol on 2026/09/28 14:37
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | The Markdown 1.0 and 1.1 syntaxes no longer work with supported XWiki versions and have been removed: their pages display a "Failed to find a parser" error instead of their content. Convert these pages to [[Markdown>>doc:documentation.extensions.admin.markdown.WebHome]] 1.2, once it is [[installed and enabled>>doc:documentation.extensions.admin.markdown.install.WebHome]]. | ||
| 2 | |||
| 3 | 1. List the pages to migrate: create a page with the following content and view it. It lists the pages of the current wiki written in Markdown 1.0 or 1.1.((( | ||
| 4 | {{code language="none"}} | ||
| 5 | {{velocity}} | ||
| 6 | #foreach ($ref in $services.query.xwql("where doc.syntaxId in ('markdown/1.0', 'markdown/1.1')").execute()) | ||
| 7 | * [[$ref]] | ||
| 8 | #end | ||
| 9 | {{/velocity}} | ||
| 10 | {{/code}} | ||
| 11 | ))) | ||
| 12 | 1. Open a page of the list and click "Edit". The page opens in the wiki editor. | ||
| 13 | 1. Select "CommonMark Markdown 1.2" in the "Page syntax" field and click "OK" in the "Syntax Conversion" dialog. The content is not converted automatically.((( | ||
| 14 | {{image reference="page-syntax-change.png" alt="Syntax Conversion dialog explaining that the conversion from Markdown 1.1 to CommonMark Markdown 1.2 is not supported, with the OK button highlighted" size="large"/}} | ||
| 15 | ))) | ||
| 16 | 1. Rewrite the constructs that Markdown 1.2 writes differently, for example:((( | ||
| 17 | |=Construct|=Markdown 1.0 and 1.1|=Markdown 1.2 | ||
| 18 | |Link to a wiki page|{{code language="none"}}[installation guide](Sandbox.WebHome){{/code}}|{{code language="none"}}[[installation guide|Sandbox.WebHome]]{{/code}} | ||
| 19 | |Inline macro|{{code language="none"}}#[info](Back up the wiki first.){{/code}}|{{code language="none"}}{{info}}Back up the wiki first.{{/info}}{{/code}} | ||
| 20 | |Macro without content|{{code language="none"}}#[toc]{{/code}}|{{code language="none"}}{{toc/}}{{/code}} | ||
| 21 | |Footnote|{{code language="none"}}Text[^1].{{/code}}|No equivalent: move the note into the text | ||
| 22 | |||
| 23 | The rest of the content is written the same way, see the [[Markdown 1.2 Syntax>>doc:documentation.extensions.user.markdown.syntax.WebHome]]. | ||
| 24 | ))) | ||
| 25 | 1. Click "Save & View". The page displays its content again.((( | ||
| 26 | {{image reference="migrated-page.png" alt="Migrated page displaying a link, an information box, a heading and a bulleted list" size="extra"/}} | ||
| 27 | ))) |
