bảng đánh dấu có đường dài

Question

Tôi đang sử dụng markdown để tạo bảng. Cột Mô tả của tôi chứa các văn bản rất dài và có vẻ như rất xấu trên tệp đánh dấu khi tôi quấn các dòng:

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. 

Tôi muốn bọc dòng vì nó dễ đọc hơn đối với tôi.
Có cách nào để làm cho bảng dễ đọc hơn cho trình chỉnh sửa không?

Answer 1

Tôi tin @Naor là đúng: Bạn phải sử dụng HTML để tạo ngắt dòng, dù rằng không được thể hiện trong câu trả lời. Và mã bảng đầy đủ được hiển thị không thực sự cần thiết: Để đạt được ngắt dòng, bạn chỉ cần không gian đôi hoặc thẻ <br />. From the Markdown spec:

Đánh dấu hỗ trợ đoạn văn bản “bọc cứng”. Điều này khác đáng kể so với hầu hết các trình định dạng text-to-HTML khác (bao gồm cả tùy chọn “Chuyển đổi ngắt dòng”) có thể dịch mỗi ký tự dòng trong đoạn thành một thẻ <br />.

Khi bạn muốn chèn một thẻ ngắt <br /> bằng cách sử dụng Markdown, bạn kết thúc một dòng có hai hoặc nhiều khoảng trắng, sau đó nhập trở lại.

Lưu ý rằng tôi phải thêm trình bao bọc mã vào văn bản vì Markdown có hương vị SO yêu cầu thẻ ngắt HTML bị thoát - vì vậy chúng tôi biết <br /> hoạt động.

Tuy nhiên, nếu bạn muốn làm một cái gì đó phức tạp hơn một chút, như tôi * Bạn có thể thiết lập các thuộc tính khác nhau với HTML như vậy:

<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> 

Tôi đã cố gắng thêm style="width:75%" đến <td> s, để không ảnh hưởng đến .

* Tôi nên lưu ý rằng tôi đã gặp vấn đề này vì tôi gặp vấn đề tương tự khi viết mã trong các bảng bằng cách sử dụng Markdown có GitHub, rất đau. Nhưng tôi lưu ý điều này bởi vì nó nên tô màu các ví dụ tôi đưa ra: Bất kỳ điều gì tôi nói 'công trình' hoặc 'không hoạt động' đều xuất phát từ môi trường đó.

CHỈNH SỬA: Có thể cần lưu ý thêm điều này là không liên quan nếu bạn có các khối code trong bảng của mình. Tuy nhiên, đây không phải là vấn đề với Markdown: HTML <code></code> các khối khiến bảng căng ra.

Answer 2

Đáng buồn là bạn phải sử dụng HTML cho điều này

<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

Xin chào, tôi đã tự hỏi điều tương tự. Tôi cần thiết này cho một tập tin tài liệu và đây là cách làm thế nào tôi đang đối phó với điều này:

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

Tôi đồng ý với Sam trong câu hỏi trên rằng Markdown giả sử là "Hard-bọc" ngôn ngữ và có cho điều này là gian lận (tôi đoán đó không phải là một Markdown hợp lệ).Nhưng ví dụ như trong một vài Github dự án README.md file tôi thấy mọi người gói mục danh sách như thế này:

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

Ngoài ra tôi học chỉ ra rằng http://www.tablesgenerator.com/markdown_tables được gói bảng cách tương tự (nhờ Tom)

Vì vậy, những gì tôi nghĩ là ok để sử dụng ví dụ của tôi nếu bạn đang làm một cái gì đó sẽ không được phân tích cú pháp (như tài liệu Github) nhưng bạn không nên quấn nếu bạn đang làm một số Markdown để phân tích cú pháp HTML hoặc bảng kiểm tra Cucumber.

Nhưng tôi có thể sai

Answer 4

Có một tùy chọn khác. Vì triết lý là Markdown được cho là nhẹ, không phải là ngôn ngữ đánh dấu và dành cho tiêu dùng tự nhiên của con người (trái ngược với định dạng kiểu SGML/HTML), tôi tin rằng sẽ tốt hơn và tự nhiên để quay lại nghệ thuật ASCII cho các trường hợp đặc biệt .

Đối với tác vụ cụ thể này, nghệ thuật nhân vật là tự nhiên. Vì vậy, chỉ cần thụt lề bảng của bạn với bốn không gian, định dạng nó độc đáo cho khả năng đọc, và Markdown sẽ chỉ coi nó là văn bản được định dạng trước, và cả hai bên có thể ngừng đánh nhau.

Ví dụ:

| 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.             | 
|-------------|---------------------------------------------------------------| 

... và thực hiện.