search

rtomayko / ronn

the opposite of roff
http://rtomayko.github.com/ronn/
Other
1.36k stars 84 forks source link

<anglequotes> don't work when contents is valid html tag #95

Open rfdonnelly opened 8 years ago

rfdonnelly commented 8 years ago

Failing input:(note use of <dir>)

General options:

  * `-d`, `--output-directory` <dir>:
    Some text.

  * `-j`, `--max-jobs` <jobs>:
    More text.

Failing output: "dir" and "Some text." is missing.

       General options:

       -d, --output-directory

       -j, --max-jobs jobs
              More text.
apjanke commented 5 years ago

So, I think this is expected: because Markdown allows you to mix in HTML markup, it expects any <foo> tags to be valid HTML tags.

If you want to render a literal <, you should use the &lt; HTML entity:

General options:

  * `-d`, `--output-directory` &lt;dir>:
    Some text.

  * `-j`, `--max-jobs` &lt;jobs>:
    More text.

Sorry about the inconvenience here, but it seems (to me) to be the only way to resolve the format specifications.