This is an automated email from the ASF dual-hosted git repository.

kwin pushed a commit to branch feature/site-markdown
in repository https://gitbox.apache.org/repos/asf/maven-doxia.git

commit 10fbc31ec171dcab39950ed456ca0ad2236e2ee0
Author: Konrad Windszus <[email protected]>
AuthorDate: Tue Mar 10 16:10:35 2026 +0100

    Convert to Markdown
---
 .../src/site/markdown/using-randomaccesssink.md    | 129 +++++++--------
 .../src/site/markdown/using-fml-xsd.md             |  63 ++++----
 .../src/site/markdown/index.md                     | 174 +++++++++------------
 .../src/site/markdown/using-xdoc-xsd.md            |  63 ++++----
 doxia-sink-api/src/site/markdown/index.md          |  80 +++++-----
 src/site/markdown/index.md                         |  48 ++----
 6 files changed, 240 insertions(+), 317 deletions(-)

diff --git a/doxia-core/src/site/markdown/using-randomaccesssink.md 
b/doxia-core/src/site/markdown/using-randomaccesssink.md
index b1c0bbd6..8bb5dd5c 100644
--- a/doxia-core/src/site/markdown/using-randomaccesssink.md
+++ b/doxia-core/src/site/markdown/using-randomaccesssink.md
@@ -1,70 +1,59 @@
- -----
- Using RandomAccessSink
- -----
- Robert Scholte
- ------
- 2011-01-07
- ------
-
-~~ Licensed to the Apache Software Foundation (ASF) under one
-~~ or more contributor license agreements.  See the NOTICE file
-~~ distributed with this work for additional information
-~~ regarding copyright ownership.  The ASF licenses this file
-~~ to you under the Apache License, Version 2.0 (the
-~~ "License"); you may not use this file except in compliance
-~~ with the License.  You may obtain a copy of the License at
-~~
-~~   http://www.apache.org/licenses/LICENSE-2.0
-~~
-~~ Unless required by applicable law or agreed to in writing,
-~~ software distributed under the License is distributed on an
-~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-~~ KIND, either express or implied.  See the License for the
-~~ specific language governing permissions and limitations
-~~ under the License.
-
-~~ NOTE: For help with the syntax of this file, see:
-~~ http://maven.apache.org/doxia/references/apt-format.html
-
-Using the RandomAccessSink
-
-  The RandomAccessSink is a Sink with the ability to add hooks. 
-  To demonstrate its usage we can have a look at a FML (FAQ Markup 
Language)-page.
-  The simple structure of such a page can be like:
-  
-+----------------+ 
-  <faq id="1">
-    <question/>
-    <answer/>
-  </faq>
-  <faq id="2">
-    <question/>
-    <answer/>
-  </faq>
-+----------------+  
-
-  Such structure would be parsed to the following page:
-  
-*-------------------------------+
-| faq\["1"\].question \+ link   \
-| faq\["2"\].question \+ link   \
-*-------------------------------+
-| faq\["1"\].question \+ anchor \
-| faq\["1"\].answer             \
-| faq\["2"\].question \+ anchor \
-| faq\["2"\].answer             \
-*-------------------------------+  
-
-  With a Sink you can only append and there's no option to buffer.
-  This would mean that you have to go twice over the structure: once for only 
the questions and once for the question + answer.
-  
-  When using the RandomAccesSink we can prepare the structure of the page
-  
-+--------------------------------------------------------------------------------------------------*
-  RandomAccessSink randomAccessSink = new RandomAccessSink(sinkFactory, 
outputStream, encoding);
-  Sink questions  = randomAccessSink.addSinkHook();
-  Sink qAndA      = randomAccessSink.addSinkHook();
-+--------------------------------------------------------------------------------------------------*
  
-
-  Now you can append the first question to both sinks, and append the answer 
to the second one.
-  The same can be done with the second faq-entry. 
+---
+title: Using RandomAccessSink
+author: 
+  - Robert Scholte
+date: 2011-01-07
+---
+
+<!-- Licensed to the Apache Software Foundation (ASF) under one-->
+<!-- or more contributor license agreements.  See the NOTICE file-->
+<!-- distributed with this work for additional information-->
+<!-- regarding copyright ownership.  The ASF licenses this file-->
+<!-- to you under the Apache License, Version 2.0 (the-->
+<!-- "License"); you may not use this file except in compliance-->
+<!-- with the License.  You may obtain a copy of the License at-->
+<!---->
+<!--   http://www.apache.org/licenses/LICENSE-2.0-->
+<!---->
+<!-- Unless required by applicable law or agreed to in writing,-->
+<!-- software distributed under the License is distributed on an-->
+<!-- "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY-->
+<!-- KIND, either express or implied.  See the License for the-->
+<!-- specific language governing permissions and limitations-->
+<!-- under the License.-->
+<!-- NOTE: For help with the syntax of this file, see:-->
+<!-- http://maven.apache.org/doxia/references/apt-format.html-->
+# Using the RandomAccessSink
+
+The RandomAccessSink is a Sink with the ability to add hooks. To demonstrate 
its usage we can have a look at a FML \(FAQ Markup Language\)-page. The simple 
structure of such a page can be like:
+
+```unknown
+  <faq id="1">
+    <question/>
+    <answer/>
+  </faq>
+  <faq id="2">
+    <question/>
+    <answer/>
+  </faq>
+```
+
+Such structure would be parsed to the following page:
+
+|   |
+|:---|
+|faq\[&quot;1&quot;\].question + link <br />faq\[&quot;2&quot;\].question + 
link |
+|faq\[&quot;1&quot;\].question + anchor <br />faq\[&quot;1&quot;\].answer <br 
/>faq\[&quot;2&quot;\].question + anchor <br />faq\[&quot;2&quot;\].answer |
+
+With a Sink you can only append and there&apos;s no option to buffer. This 
would mean that you have to go twice over the structure: once for only the 
questions and once for the question + answer.
+
+When using the RandomAccesSink we can prepare the structure of the page
+
+```unknown
+  RandomAccessSink randomAccessSink = new RandomAccessSink(sinkFactory, 
outputStream, encoding);
+  Sink questions  = randomAccessSink.addSinkHook();
+  Sink qAndA      = randomAccessSink.addSinkHook();
+```
+
+Now you can append the first question to both sinks, and append the answer to 
the second one. The same can be done with the second faq-entry. 
+
diff --git a/doxia-modules/doxia-module-fml/src/site/markdown/using-fml-xsd.md 
b/doxia-modules/doxia-module-fml/src/site/markdown/using-fml-xsd.md
index 19bc3245..b0246ad5 100644
--- a/doxia-modules/doxia-module-fml/src/site/markdown/using-fml-xsd.md
+++ b/doxia-modules/doxia-module-fml/src/site/markdown/using-fml-xsd.md
@@ -1,43 +1,40 @@
- -----
- Using Schema FML 1.0.1
- -----
- Vincent Siveton
- ------
- 2009-06-15
- ------
+---
+title: Using Schema FML 1.0.1
+author: 
+  - Vincent Siveton
+date: 2009-06-15
+---
 
-~~ Licensed to the Apache Software Foundation (ASF) under one
-~~ or more contributor license agreements.  See the NOTICE file
-~~ distributed with this work for additional information
-~~ regarding copyright ownership.  The ASF licenses this file
-~~ to you under the Apache License, Version 2.0 (the
-~~ "License"); you may not use this file except in compliance
-~~ with the License.  You may obtain a copy of the License at
-~~
-~~   http://www.apache.org/licenses/LICENSE-2.0
-~~
-~~ Unless required by applicable law or agreed to in writing,
-~~ software distributed under the License is distributed on an
-~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-~~ KIND, either express or implied.  See the License for the
-~~ specific language governing permissions and limitations
-~~ under the License.
+<!-- Licensed to the Apache Software Foundation (ASF) under one-->
+<!-- or more contributor license agreements.  See the NOTICE file-->
+<!-- distributed with this work for additional information-->
+<!-- regarding copyright ownership.  The ASF licenses this file-->
+<!-- to you under the Apache License, Version 2.0 (the-->
+<!-- "License"); you may not use this file except in compliance-->
+<!-- with the License.  You may obtain a copy of the License at-->
+<!---->
+<!--   http://www.apache.org/licenses/LICENSE-2.0-->
+<!---->
+<!-- Unless required by applicable law or agreed to in writing,-->
+<!-- software distributed under the License is distributed on an-->
+<!-- "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY-->
+<!-- KIND, either express or implied.  See the License for the-->
+<!-- specific language governing permissions and limitations-->
+<!-- under the License.-->
+<!-- NOTE: For help with the syntax of this file, see:-->
+<!-- http://maven.apache.org/doxia/references/apt-format.html-->
+# Using Schema FML 1\.0\.1
 
-~~ NOTE: For help with the syntax of this file, see:
-~~ http://maven.apache.org/doxia/references/apt-format.html
+The FML XSD is located [here](https://maven.apache.org/xsd/fml-1.0.1.xsd).
 
-Using Schema FML 1.0.1
-
-  The FML XSD is located {{{https://maven.apache.org/xsd/fml-1.0.1.xsd}here}}.
-
-  Your favorite IDE probably supports XSD schema's for .fml files. You need to 
specify the following:
-
-+-----+
+Your favorite IDE probably supports XSD schema&apos;s for .fml files. You need 
to specify the following:
 
+```unknown
 <faqs xmlns="http://maven.apache.org/FML/1.0.1";
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance";
   xsi:schemaLocation="http://maven.apache.org/FML/1.0.1 
https://maven.apache.org/xsd/fml-1.0.1.xsd";
   title="...">
 ...
 </faqs>
-+-----+
+```
+
diff --git a/doxia-modules/doxia-module-markdown/src/site/markdown/index.md 
b/doxia-modules/doxia-module-markdown/src/site/markdown/index.md
index 55aad201..86db9be0 100644
--- a/doxia-modules/doxia-module-markdown/src/site/markdown/index.md
+++ b/doxia-modules/doxia-module-markdown/src/site/markdown/index.md
@@ -1,100 +1,74 @@
- -----
- doxia-module-markdown
- -----
- Vladimir Schneider <[email protected]>, Julien Nicoulaud 
<[email protected]>
- ------
- 2017-03-04
- ------
-
-~~ Licensed to the Apache Software Foundation (ASF) under one
-~~ or more contributor license agreements.  See the NOTICE file
-~~ distributed with this work for additional information
-~~ regarding copyright ownership.  The ASF licenses this file
-~~ to you under the Apache License, Version 2.0 (the
-~~ "License"); you may not use this file except in compliance
-~~ with the License.  You may obtain a copy of the License at
-~~
-~~   http://www.apache.org/licenses/LICENSE-2.0
-~~
-~~ Unless required by applicable law or agreed to in writing,
-~~ software distributed under the License is distributed on an
-~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-~~ KIND, either express or implied.  See the License for the
-~~ specific language governing permissions and limitations
-~~ under the License.
-
-~~ NOTE: For help with the syntax of this file, see:
-~~ http://maven.apache.org/doxia/references/apt-format.html
-
-doxia-module-markdown
-
-  Markdown is a popular lightweight markup language, easy to read and easy to 
write.
-  It is supported by a large panel of websites, text editors/IDEs and 
converter tools.
-  Markdown format is supported both as source (parser) and destination (sink), 
the latter only since version 1.12.0.
-
-* Metadata
-
-  Although metadata was not part of the original Markdown format it is now 
widely supported through multiple extensions.
-  This modules supports the following two metadata formats:
-
-  * {{{http://fletcher.github.io/MultiMarkdown-5/metadata.html}MultiMarkdown 
Metadata}}
-
-  * 
{{{https://github.com/vsch/flexmark-java/wiki/Extensions#yaml-front-matter}YAML 
front matter}}
-  
-  Metadata must be placed at the beginning of the document, before any other 
content.
-  
-  []
-
-  Currently only the following metadata elements are supported:
-  
-  * <<<title>>> - the title of the document, used as the sink's title
-  
-  * <<<author>>> - the author of the document, used as the sink's author
-  
-  * <<<date>>> - the date of the document, used as the sink's date
-  
-  * everything else is just written as meta tags in the output document
-  
-
-* Extensions
-
-  As the original Markdown specification is simple many extensions have been 
created to add features to the original Markdown format.
-  The following extensions are supported by this module:
-  
-** GFM (GitHub Flavored Markdown) extensions:
-  
-  GitHub specified {{{https://github.github.com/gfm}extensions}} to the 
original Markdown format, which are now widely used. 
-  Some of these extensions are also supported by this module.
-  
-  * {{{https://github.github.com/gfm/#tables-extension-}tables}}
-  
-  * {{{https://github.github.com/gfm/#strikethrough-extension-}strikethrough 
text}}
-
-** Others
-
-  * {{{https://github.com/vsch/flexmark-java/wiki/Extensions#wikilinks}wiki 
links}}
-  
-  * 
{{{https://github.com/vsch/flexmark-java/wiki/Footnotes-Extension}footnotes}}
-  
-  * {{{https://michelf.ca/projects/php-markdown/extra/#abbr}abbreviations}}
-  
-  * {{{https://michelf.ca/projects/php-markdown/extra/#def-list}definition 
lists}}
-  
-* Parser
-
-  The parser will first convert Markdown into HTML and then parse the HTML 
into Doxia Sink API methods calls leveraging the 
-  {{{../doxia-module-xhtml5/index.html}XHTML5 parser}}.
-
-* References
-
-   * {{{http://daringfireball.net/projects/markdown}Markdown project website}}
-
-   * {{{http://en.wikipedia.org/wiki/Markdown}Markdown Wikipedia page}}
-
-   * {{{http://xbeta.org/wiki/show/Markdown}Markdown wiki}}
-
-   * {{{http://github.com/vsch/flexmark-java}flexmark-java}}, the library used 
by this Doxia module
-     in {{{http://pegdown.org}Pegdown}} compatibility mode
-
-   * {{{http://pegdown.org}Pegdown}} a deprecated Markdown processing library 
used in previous
-     doxia-module-markdown versions 1.3 to 1.7
+---
+title: doxia-module-markdown
+author: 
+  - Vladimir Schneider [email protected]_, Julien Nicoulaud 
[email protected]_
+date: 2017-03-04
+---
+
+<!-- Licensed to the Apache Software Foundation (ASF) under one-->
+<!-- or more contributor license agreements.  See the NOTICE file-->
+<!-- distributed with this work for additional information-->
+<!-- regarding copyright ownership.  The ASF licenses this file-->
+<!-- to you under the Apache License, Version 2.0 (the-->
+<!-- "License"); you may not use this file except in compliance-->
+<!-- with the License.  You may obtain a copy of the License at-->
+<!---->
+<!--   http://www.apache.org/licenses/LICENSE-2.0-->
+<!---->
+<!-- Unless required by applicable law or agreed to in writing,-->
+<!-- software distributed under the License is distributed on an-->
+<!-- "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY-->
+<!-- KIND, either express or implied.  See the License for the-->
+<!-- specific language governing permissions and limitations-->
+<!-- under the License.-->
+<!-- NOTE: For help with the syntax of this file, see:-->
+<!-- http://maven.apache.org/doxia/references/apt-format.html-->
+
+# doxia-module-markdown
+
+Markdown is a popular lightweight markup language, easy to read and easy to 
write. It is supported by a large panel of websites, text editors/IDEs and 
converter tools. Markdown format is supported both as source \(parser\) and 
destination \(sink\), the latter only since version 1\.12\.0\.
+
+## Metadata
+
+Although metadata was not part of the original Markdown format it is now 
widely supported through multiple extensions. This modules supports the 
following two metadata formats:
+
+- [MultiMarkdown 
Metadata](http://fletcher.github.io/MultiMarkdown-5/metadata.html)
+- [YAML front 
matter](https://github.com/vsch/flexmark-java/wiki/Extensions#yaml-front-matter)
+
+*Metadata must be placed at the beginning of the document, before any other 
content.*
+
+Currently only the following metadata elements are supported:
+
+- `title` - the title of the document, used as the sink&apos;s title
+- `author` - the author of the document, used as the sink&apos;s author
+- `date` - the date of the document, used as the sink&apos;s date
+- everything else is just written as meta tags in the output document
+
+## Extensions
+
+As the original Markdown specification is simple many extensions have been 
created to add features to the original Markdown format. The following 
extensions are supported by this module:
+
+### GFM \(GitHub Flavored Markdown\) extensions:
+
+GitHub specified [extensions](https://github.github.com/gfm) to the original 
Markdown format, which are now widely used. Some of these extensions are also 
supported by this module.
+
+- [tables](https://github.github.com/gfm/#tables-extension-)
+- [strikethrough text](https://github.github.com/gfm/#strikethrough-extension-)
+
+### Others
+
+- [wiki links](https://github.com/vsch/flexmark-java/wiki/Extensions#wikilinks)
+- [footnotes](https://github.com/vsch/flexmark-java/wiki/Footnotes-Extension)
+- [abbreviations](https://michelf.ca/projects/php-markdown/extra/#abbr)
+- [definition lists](https://michelf.ca/projects/php-markdown/extra/#def-list)
+## Parser
+
+The parser will first convert Markdown into HTML and then parse the HTML into 
Doxia Sink API methods calls leveraging the [XHTML5 
parser](../doxia-module-xhtml5/index.html).
+
+## References
+
+- [Markdown project website](http://daringfireball.net/projects/markdown)
+- [Markdown Wikipedia page](http://en.wikipedia.org/wiki/Markdown)
+- [Markdown wiki](http://xbeta.org/wiki/show/Markdown)
+- [flexmark-java](http://github.com/vsch/flexmark-java), the library used by 
this Doxia module in [Pegdown](http://pegdown.org) compatibility mode
+- [Pegdown](http://pegdown.org) a deprecated Markdown processing library used 
in previous doxia-module-markdown versions 1\.3 to 1\.7
diff --git 
a/doxia-modules/doxia-module-xdoc/src/site/markdown/using-xdoc-xsd.md 
b/doxia-modules/doxia-module-xdoc/src/site/markdown/using-xdoc-xsd.md
index e7001ce2..9cd52199 100644
--- a/doxia-modules/doxia-module-xdoc/src/site/markdown/using-xdoc-xsd.md
+++ b/doxia-modules/doxia-module-xdoc/src/site/markdown/using-xdoc-xsd.md
@@ -1,42 +1,39 @@
- -----
- Using Schema XDOC 2.0
- -----
- Vincent Siveton
- ------
- 2009-01-28
- ------
+---
+title: Using Schema XDOC 2.0
+author: 
+  - Vincent Siveton
+date: 2009-01-28
+---
 
-~~ Licensed to the Apache Software Foundation (ASF) under one
-~~ or more contributor license agreements.  See the NOTICE file
-~~ distributed with this work for additional information
-~~ regarding copyright ownership.  The ASF licenses this file
-~~ to you under the Apache License, Version 2.0 (the
-~~ "License"); you may not use this file except in compliance
-~~ with the License.  You may obtain a copy of the License at
-~~
-~~   http://www.apache.org/licenses/LICENSE-2.0
-~~
-~~ Unless required by applicable law or agreed to in writing,
-~~ software distributed under the License is distributed on an
-~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-~~ KIND, either express or implied.  See the License for the
-~~ specific language governing permissions and limitations
-~~ under the License.
+<!-- Licensed to the Apache Software Foundation (ASF) under one-->
+<!-- or more contributor license agreements.  See the NOTICE file-->
+<!-- distributed with this work for additional information-->
+<!-- regarding copyright ownership.  The ASF licenses this file-->
+<!-- to you under the Apache License, Version 2.0 (the-->
+<!-- "License"); you may not use this file except in compliance-->
+<!-- with the License.  You may obtain a copy of the License at-->
+<!---->
+<!--   http://www.apache.org/licenses/LICENSE-2.0-->
+<!---->
+<!-- Unless required by applicable law or agreed to in writing,-->
+<!-- software distributed under the License is distributed on an-->
+<!-- "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY-->
+<!-- KIND, either express or implied.  See the License for the-->
+<!-- specific language governing permissions and limitations-->
+<!-- under the License.-->
+<!-- NOTE: For help with the syntax of this file, see:-->
+<!-- http://maven.apache.org/doxia/references/apt-format.html-->
+# Using Schema XDOC 2\.0
 
-~~ NOTE: For help with the syntax of this file, see:
-~~ http://maven.apache.org/doxia/references/apt-format.html
+The XDOC XSD is located [here](https://maven.apache.org/xsd/xdoc-2.0.xsd).
 
-Using Schema XDOC 2.0
-
-  The XDOC XSD is located {{{https://maven.apache.org/xsd/xdoc-2.0.xsd}here}}.
-
-  Your favorite IDE probably supports XSD schema's for .xml/.xdoc files. You 
need to specify the following:
-
-+-----+
+Your favorite IDE probably supports XSD schema&apos;s for .xml/.xdoc files. 
You need to specify the following:
 
+```unknown
 <document xmlns="http://maven.apache.org/XDOC/2.0";
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance";
   xsi:schemaLocation="http://maven.apache.org/XDOC/2.0 
https://maven.apache.org/xsd/xdoc-2.0.xsd";>
 ...
 </document>
-+-----+
+```
+
diff --git a/doxia-sink-api/src/site/markdown/index.md 
b/doxia-sink-api/src/site/markdown/index.md
index 86c118d3..42666414 100644
--- a/doxia-sink-api/src/site/markdown/index.md
+++ b/doxia-sink-api/src/site/markdown/index.md
@@ -1,51 +1,45 @@
- -----
- Doxia Sink API
- -----
- Hervé Boutemy
- -----
- 2010-05-08
- -----
-
-~~ Licensed to the Apache Software Foundation (ASF) under one
-~~ or more contributor license agreements.  See the NOTICE file
-~~ distributed with this work for additional information
-~~ regarding copyright ownership.  The ASF licenses this file
-~~ to you under the Apache License, Version 2.0 (the
-~~ "License"); you may not use this file except in compliance
-~~ with the License.  You may obtain a copy of the License at
-~~
-~~   http://www.apache.org/licenses/LICENSE-2.0
-~~
-~~ Unless required by applicable law or agreed to in writing,
-~~ software distributed under the License is distributed on an
-~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-~~ KIND, either express or implied.  See the License for the
-~~ specific language governing permissions and limitations
-~~ under the License.
-
-~~ NOTE: For help with the syntax of this file, see:
-~~ http://maven.apache.org/doxia/references/apt-format.html
-
-Doxia Sink API
-
-  The <Sink> interface is a generic markup language interface provided as a 
Java API.
-It contains several methods that encapsulate common text syntax. A start tag 
is denoted by
-<<<xxxx()>>> method and a end of tag by <<<xxxx_()>>> method.
-
-  For instance, you could do things like:
-
-+--
+---
+title: Doxia Sink API
+author: 
+  - Hervé Boutemy
+date: 2010-05-08
+---
+
+<!-- Licensed to the Apache Software Foundation (ASF) under one-->
+<!-- or more contributor license agreements.  See the NOTICE file-->
+<!-- distributed with this work for additional information-->
+<!-- regarding copyright ownership.  The ASF licenses this file-->
+<!-- to you under the Apache License, Version 2.0 (the-->
+<!-- "License"); you may not use this file except in compliance-->
+<!-- with the License.  You may obtain a copy of the License at-->
+<!---->
+<!--   http://www.apache.org/licenses/LICENSE-2.0-->
+<!---->
+<!-- Unless required by applicable law or agreed to in writing,-->
+<!-- software distributed under the License is distributed on an-->
+<!-- "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY-->
+<!-- KIND, either express or implied.  See the License for the-->
+<!-- specific language governing permissions and limitations-->
+<!-- under the License.-->
+<!-- NOTE: For help with the syntax of this file, see:-->
+<!-- http://maven.apache.org/doxia/references/apt-format.html-->
+# Doxia Sink API
+
+The _Sink_ interface is a generic markup language interface provided as a Java 
API. It contains several methods that encapsulate common text syntax. A start 
tag is denoted by `xxxx()` method and a end of tag by `xxxx_()` method.
+
+For instance, you could do things like:
+
+```unknown
 sink.paragraph();
 sink.text("my text");
 sink.paragraph_();
-+--
+```
 
-  similar to this HTML markup:
+similar to this HTML markup:
 
-+--
+```unknown
 <p>my text</p>
-+--
+```
 
-  To find out more about the Sink API, you can read the
-  {{{./apidocs/org/apache/maven/doxia/sink/Sink.html}Javadoc}}.
+To find out more about the Sink API, you can read the 
[Javadoc](./apidocs/org/apache/maven/doxia/sink/Sink.html).
 
diff --git a/src/site/markdown/index.md b/src/site/markdown/index.md
index 22430b00..497b0959 100644
--- a/src/site/markdown/index.md
+++ b/src/site/markdown/index.md
@@ -1,4 +1,8 @@
-<?xml version="1.0"?>
+---
+title: About
+author: 
+  - Hervé Boutemy
+---
 
 <!--
 /*
@@ -19,45 +23,13 @@
  */
 -->
 
-<document>
+# Doxia
 
-  <properties>
-    <title>About</title>
-    <author email="hboutemy_AT_apache_DOT_org">Hervé Boutemy</author>
-  </properties>
+Doxia is a content generation framework that provides powerful techniques for 
generating static and dynamic content, supporting [a variety of markup 
languages](/doxia/references/index.html).
 
-  <body>
+The actual component is the base component from the whole Doxia suite, with 
the core parser and sink APIs and their implementation in supported markup 
languages.
 
-    <section name="Doxia">
+It is used by the [Doxia Sitetools](../doxia-sitetools) extension, that adds 
site and documents support.
 
-      <p>Doxia is a content generation framework that provides powerful 
techniques for generating static and dynamic content,
-       supporting <a href="/doxia/references/index.html">a variety of markup 
languages</a>.</p>
+![](images/doxia-deps.png) 
 
-      <p>The actual component is the base component from the whole Doxia 
suite, with the core parser and sink APIs and
-      their implementation in supported markup languages.</p>
-
-      <p>It is used by the <a href="../doxia-sitetools">Doxia Sitetools</a> 
extension,
-      that adds site and documents support.</p>
-
-      <p>
-        <img src="images/doxia-deps.png" border="0" 
usemap="#Doxia_dependencies" />
-        <map name="Doxia_dependencies">
-          <area shape="rect" coords="0,280,122,308"  href="./doxia-test-docs/" 
/>
-          <area shape="rect" coords="135,231,286,261" href="./doxia-sink-api/" 
/>
-          <area shape="rect" coords="165,180,286,209" href="./doxia-core/" />
-          <area shape="rect" coords="41,25,118,88"    
href="./doxia-modules/doxia-module-apt/" />
-          <area shape="rect" coords="212,75,289,107"   
href="./doxia-modules/doxia-module-xdoc/" />
-          <area shape="rect" coords="230,25,313,88"   
href="./doxia-modules/doxia-module-xhtml5/" />
-          <area shape="rect" coords="135,25,213,88"   
href="./doxia-modules/doxia-module-fml/" />
-          <area shape="rect" coords="304,75,421,107"  
href="./doxia-modules/doxia-module-markdown/" />
-          <area shape="rect" coords="21,1,432,151"     href="./doxia-modules/" 
/>
-          <area shape="rect" coords="308,178,439,208"  
href="https://github.com/vsch/flexmark-java"; />
-          <area shape="rect" coords="164,280,286,310" 
href="https://codehaus-plexus.github.io/"; />
-        </map>
-      </p>
-
-    </section>
-
-  </body>
-
-</document>

Reply via email to