таблица разметки с длинными линиями

Question

Я использую уценку, чтобы создать таблицу. Мое Описание столбец содержит очень длинные тексты, и для этого он выглядит очень плохо на файл уценка, когда я оберните строки:

Argument   | Description | 
--------   | ----------- | 
appDir    | The top level directory that contains your app. If this 
option is used then it assumed your scripts are in |a subdirectory under this path. This option is not required. If it is not specified, then baseUrl below is the anchor point for finding things. If this option is specified, then all the files from the app directory will be copied to the dir: output area, and baseUrl will assume to be a relative path under this directory. 
baseUrl    | By default, all modules are located relative to this path. If baseUrl is not explicitly set, then all modules are loaded relative to the directory that holds the build file. If appDir is set, then baseUrl should be specified as relative to the appDir. 
dir     | The directory path to save the output. If not specified, then the path will default to be a directory called "build" as a sibling to the build file. All relative paths are relative to the build file. 
modules    | List the modules that will be optimized. All their immediate and deep dependencies will be included in the module's file when the build is done. If that module or any of its dependencies includes i18n bundles, only the root bundles will be included unless the locale: section is set above. 

Я хочу, чтобы обернуть линии, поскольку она является более удобной для чтения для меня.
Есть ли способ сделать таблицу более читаемой для редактора?

Answer 1

Я считаю @Naor прав: Вы должны использовать HTML, чтобы создать разрывы строк, хотя это и не показано в ответе. И полный отображаемый код таблицы не является абсолютно необходимым: для достижения разрыва строки вам нужно только двойное пространство или тег <br />. From the Markdown spec:

Markdown поддерживает «жесткие» абзацы текста. Это значительно отличает от большинства других форматировщиков текста в HTML (в том числе вариант «Конвертировать линейные разрывы» для подвижного типа), которые переводят каждый символ строки в абзаце в тег <br />.

Если вы хотите вставить тэг <br /> с помощью Markdown, вы закончите строку с двумя или более пробелами, затем введите return.

Обратите внимание, что я должен был добавить код оберток к тексту, так как SO-приправленные уценки требуют теги перерыва HTML спасшихся - так что мы знаем <br /> работы.

Но, если вы хотите сделать что-то немного более сложным, как я * Вы можете установить различные свойства с HTML следующим образом:

<table width="300"> 
    <tr> 
    <td> This is some text </td> 
    <td> This is some somewhat longer block of text </td> 
    <td> This is some very long block of text repeated to make it even longer. This is some very long block of text repeated to make it even longer. This is some very long block of text repeated to make it even longer. </td> 
    </tr> 
</table> 

Я попытался добавления style="width:75%" к <td> с, чтобы не влиять на ,

* Следует отметить, что я натолкнулся на это, потому что у меня возникают аналогичные проблемы с написанием кода внутри таблиц с использованием GritHub-приправленного Markdown, что очень болезненно. Но я это замечаю, потому что он должен окрасить примеры, которые я даю: любая вещь, которую я говорю «работает» или «не работает», исходит из этой среды.

EDIT: Возможно, стоит отметить, что это не имеет значения, если у вас есть code блоков внутри вашего стола. Это не проблема с Markdown: HTML <code></code> блоков заставляют таблицу растягиваться.

Answer 2

К сожалению, вы должны использовать HTML для этого

<table> 
<tr> 
<th>Argument</th> 
<th>Description</th> 
</tr> 
<tr> 
<td>appDir</td> 
<td>The top level directory that contains your app. If this option is used then 
it assumed your scripts are in</td> 
</tr> 
<tr> 
<td>baseUrl</td> 
<td>By default, all modules are located relative to this path. If baseUrl is not 
explicitly set, then all modules are loaded relative to the directory that holds 
the build file. If appDir is set, then baseUrl should be specified as relative 
to the appDir.</td> 
</tr> 
<tr> 
<td>dir</td> 
<td>The directory path to save the output. If not specified, then the path will 
default to be a directory called "build" as a sibling to the build file. All 
relative paths are relative to the build file.</td> 
</tr> 
<tr> 
<td>modules</td> 
<td>List the modules that will be optimized. All their immediate and deep 
dependencies will be included in the module's file when the build is done. If 
that module or any of its dependencies includes i18n bundles, only the root 
bundles will be included unless the locale: section is set above.</td> 
</tr> 
</table> 

Answer 3

Привет, меня интересовало то же самое. Я нуждался в этом для файла документации, и это так, как я имею дело с этим:

| key | description      | 
| --- | ---        | 
| foo | bla bla blabla bla blabla bla bla | 
|  | bla bla blabla bla bla bla bla bla | 
| bar | something else bla     | 

Я согласен с Сэмом в вопросе выше, что Markdown предполагают, чтобы быть «Hard-завернутые» язык и там для этого есть обман (я думаю, это не допустимый Markdown).Но, например, в нескольких Github проектов README.md файлы, которые я видел людей оборачивать список предметов, как это:

* foo 
* bla bla bla bla bla bla bla bla bla bla 
    bla bla bla bla bla bla bla bla bla 

Также мой колледж отметил, что http://www.tablesgenerator.com/markdown_tables обмотать таблицы подобным образом (благодаря Tom)

Так что я думаю нормально использовать мой пример, если вы делаете что-то, что не будет анализироваться (например, документация Github), но вы не должны обертываться, если вы делаете таблицу Markdown to HTML parser или Cucumber.

Но я могу ошибаться

Answer 4

Есть еще один вариант. Поскольку философия заключается в том, что Markdown должен быть легким, а не разметным языком и предназначен для естественного потребления человеком (в отличие от форматов SGML/HTML-стиля), я считаю, что вполне нормально и естественно возвращаться к искусству ASCII для особых случаев ,

Для этой конкретной задачи характерное искусство является естественным. Таким образом, просто отложите таблицу с четырьмя пробелами, отформатируйте ее для удобства чтения, а Markdown будет рассматривать ее как предварительно форматированный текст, и обе стороны могут перестать сражаться друг с другом.

Например:

| Sequence | Result              | 
|-------------|---------------------------------------------------------------| 
| `a?c`  | Matches `abc`, `axc`, and `aac`. Does not match `ac`, `abbc`, | 
|    | or `a/c`.              | 
|-------------|---------------------------------------------------------------| 
| `a*c`  | Matches "ac", "abc" and "azzzzzzzc". Does not match "a/c". | 
|-------------|---------------------------------------------------------------| 
| `foo...bar` | Matches "foobar", "fooxbar", and "fooz/blaz/rebar". Does not | 
|    | match "fo/obar", "fobar" or "food/bark".      | 
|-------------|---------------------------------------------------------------| 
| `....obj` | Matches all files anywhere in the current hierarchy that end | 
|    | in ".obj". Note that the first three periods are interpreted | 
|    | as "...", and the fourth one is interpreted as a literal "." | 
|    | character.             | 
|-------------|---------------------------------------------------------------| 

... и сделано.