Skip to content

DITA note types are inconsistently formatted when converted to Markdown #246

@michael-nok

Description

@michael-nok

The oXygen XML Author 27.1 provides support for several note types, including (but not limited to): danger, caution, and notice.

When these DITA elements are converted to Markdown, they are not processed the same way the other note types, such as note, attention, important or warning.

Sample files: dita_notes.zip

  1. Expected behavior:

    DITA content:

    <note type="note">note content.</note>
    <note type="important">note content.</note>
    

    Markdown

    **Note:** note content.
    **Important:** note content.
    
  2. Incorrect behavior exhibited by note types set to danger or caution:

    DITA content:

    <note type="danger">Danger content.</note>
    <note type="caution">Caution content.</note>
    

    Markdown: Appears in uppercase, without bold, and content is separated by carriage returns.

    DANGER
    
    Danger content.
    
    CAUTION:
    
    Caution content.
    
  3. DITA content with type=notice gets converted the same way as type=note, despite them being different.

    DITA content:

    <note type="notice">Notice content.</note>
    

    Markdown:

    **Note:** Notice content.
    

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions