sunaku / md2man

📚 Converts markdown into UNIX manual pages
https://sunaku.github.io/md2man/man
Other
374 stars 23 forks source link

Table rendering #21

Closed UNIVAC-Colonel-Panic closed 9 years ago

UNIVAC-Colonel-Panic commented 9 years ago

Hi,

Original markdown text file: http://pastebin.com/pb5pA4vD

Rendered output using md2man-roff md2man-test.1.md: http://pastebin.com/Tgd2cUav

  1. How do I get an extra blank line above the text "Table 2" and "Table 3"? You can see I have two newlines but they seem to get stripped.
  2. My ultimate goal is to have Table 2 and/or Table 3 rendered as the manually created Table 4. How do I get line wrapping within a cell?
sunaku commented 9 years ago

Sorry for the late response. :cold_sweat:

How do I get an extra blank line above the text "Table 2" and "Table 3"? You can see I have two newlines but they seem to get stripped.

Newlines are not being stripped because "new paragraph" .PP directives are being emitted correctly before every "Table N" line in the Roff output:


$ bundle exec md2man-roff test.md | grep -P -B1 'Table \d'
.PP
Table 1
--
.PP
Table 2
--
.PP
Table 3
--
.PP
Table 4

How man -l chooses to display those .PP directives is beyond my control. :sunrise_over_mountains: I suppose we could emit multiple .PP directives to start every new paragraph but it doesn't feel like the right thing to do. :scream:

My ultimate goal is to have Table 2 and/or Table 3 rendered as the manually created Table 4. How do I get line wrapping within a cell?

This is also beyond my control. :sunrise_over_mountains: You'll have to patch the Redcarpet markdown parser to recognize such multi-line table cells correctly. :dart:

Hope that helps! :sweat_smile:

UNIVAC-Colonel-Panic commented 9 years ago

I do not have the intelligence to patch Redcarpet so I guess md2man just isn't for me. Thanks for trying to help, though.