<?xml version="1.0" encoding="UTF-8"?><specification xmlns="http://docbook.org/ns/docbook" xmlns:cs="http://www.w3.org/XML/XProc/2006/04/components#" xmlns:e="http://www.w3.org/1999/XSL/Spec/ElementSyntax" xmlns:p="http://www.w3.org/ns/xproc" xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="step-text" class="ed" role="step" version="5.0-extension w3c-xproc">
  <info>
    <title>XProc 3.1: text steps</title>
    <!-- defaults to date formatted <pubdate>2014-12-18</pubdate> -->
<copyright><year>2018</year><year>2019</year><year>2020</year>
<year>2021</year><year>2022</year><year>2023</year><year>2024</year><year>2025</year>
<holder>the Contributors to the XProc 3.1 Standard Step Library
specifications</holder>
</copyright>

<bibliomisc role="repository">XProc/specification</bibliomisc>
<bibliomisc role="w3c-cg" xlink:href="https://www.w3.org/community/xproc-next/">XProc Next</bibliomisc>

    <bibliorelation type="isformatof" xlink:href="specification.xml">XML</bibliorelation>
    <authorgroup>
      <author>
        <personname>Norman Walsh</personname>
      </author>
      <author>
        <personname>Achim Berndzen</personname>
      </author>
      <author>
        <personname>Gerrit Imsieke</personname>
      </author>
      <author>
        <personname>Erik Siegel</personname>
      </author>
    </authorgroup>

    <abstract>
      <para>This specification describes the optional text related steps for <citetitle>XProc 3.1: An XML Pipeline Language</citetitle>.</para>
    </abstract>

<legalnotice xml:id="sotd" role="status">
  <para>This specification was published by the
  <link xlink:href="https://www.w3.org/community/xproc-next/">XProc
  Next Community Group</link>. It is not a W3C Standard nor is it on
  the W3C Standards Track. Please note that under the
  <link xlink:href="https://www.w3.org/community/about/agreements/cla/">W3C
  Community Contributor License Agreement (CLA)</link> there is a limited
  opt-out and other conditions apply. Learn more about <link xlink:href="https://www.w3.org/community/">W3C Community and Business
  Groups</link>.
  </para>
  
  <para>If you wish to make comments regarding this document, please
  send them to
  <link xlink:href="mailto:xproc-dev@w3.org">xproc-dev@w3.org</link>.
  (<link xlink:href="mailto:xproc-dev-request@w3.org?subject=subscribe">subscribe</link>,
  <link xlink:href="https://lists.w3.org/Archives/Public/xproc-dev/">archives</link>).
  </para>

<note role="editorial">
<para>This draft is the “editor’s working draft” and may continue to evolve.
</para>
</note>

</legalnotice>
  </info>

  <section xml:id="introduction">
    <title>Introduction</title>

    <para>This specification describes the optional text related XProc steps. A machine-readable description of these steps may be found in <link xlink:href="steps.xpl">steps.xpl</link>. </para>

    <para>Familarity with the general nature of <biblioref linkend="xproc31"/> steps is assumed.</para>
  </section>

  <section xml:id="library">
    <title>Step library</title>

  <!-- Include step descriptions: -->
  <section xml:id="c.markdown-to-html">
<title>p:markdown-to-html</title>

<para>The <code>p:markdown-to-html</code> step converts a text document in Markdown to XHTML.</para>

<p:declare-step type="p:markdown-to-html">
  <p:input port="source" primary="true" content-types="text"/>
  <p:output port="result" primary="true" content-types="html"/>
  <p:option name="parameters" as="map(xs:QName, item()*)?"/>
</p:declare-step>

<para>The <tag>p:markdown-to-html</tag> step transforms a text document containing
Markdown, for example <biblioref linkend="commonmark"/>, into HTML.
<impl>The flavor(s) of Markdown supported and the parameters allowed are
<glossterm>implementation-defined</glossterm>.</impl></para>

<simplesect>
  <title>Document properties</title>
  <para feature="load-preserves-none">No document properties are preserved.</para>
</simplesect>
</section>
  </section>

  <appendix xml:id="conformance">
<title>Conformance</title>

<para>Conformant processors <rfc2119>must</rfc2119> implement all of the features
described in this specification except those that are explicitly identified
as optional.</para>

<para>Some aspects of processor behavior are not completely specified; those
features are either <glossterm role="unwrapped">implementation-dependent</glossterm> or
<glossterm role="unwrapped">implementation-defined</glossterm>.</para>

<para><termdef xml:id="dt-implementation-dependent">An
<firstterm>implementation-dependent</firstterm> feature is one where the
implementation has discretion in how it is performed.
Implementations are not required to document or explain
how <glossterm role="unwrapped">implementation-dependent</glossterm> features are performed.</termdef>
</para>

<para><termdef xml:id="dt-implementation-defined">An
<firstterm>implementation-defined</firstterm> feature is one where the
implementation has discretion in how it is performed.
Conformant implementations <rfc2119>must</rfc2119> document
how <glossterm role="unwrapped">implementation-defined</glossterm> features are performed.</termdef>
</para>

<section xml:id="implementation-defined">
<title>Implementation-defined features</title>

<para>The following features are implementation-defined:</para>

<?implementation-defined-features?>
</section>
</appendix>

  <appendix xml:id="references">
    <title>References</title>
    <bibliolist>
      <bibliomixed xml:id="commonmark"/>
      <bibliomixed xml:id="xproc31"/>
    </bibliolist>
  </appendix>

  <!-- This glossary will automatically be elided if there are no
     terms marked up as 'firstterm's in this specification. -->
  
      <glossary xml:id="glossary">
        <title>Glossary</title>
        <para>Glossary needs to be generated</para>
      </glossary>
    

  <appendix version="5.0-extension w3c-xproc" xml:id="ancillary-files">
<title>Ancillary files</title>

<para>This specification includes by reference a number of
ancillary files.</para>

<variablelist>
<varlistentry>
<term><link xlink:href="steps.xpl"/></term>
<listitem>
<para>An XProc step library for the declared steps.
</para>
</listitem>
</varlistentry>
</variablelist>

</appendix>

</specification>