it is important to transport the table cell alignment to markdown, using the following algorithm:

• all tables will be represented as HTML tables
• default horizontal alignment is left
• default vertical alignment is top
• the non-default alignments will be applied to the cells

horizontal alignment

vertical alignment

Description
the sanitizeTextAndFormats function can cause an endless loop for nested formats.

alternative table representations to support container content in table cells

the problem with markdown tables is, that the cells can't contain container elements. so for tables with container elements, we use html tables. so far word2md used to convert the entire sub-tree to html.

according to https://spec.commonmark.org/0.29/#html-block, a HTML block is terminated by a blank line.
example:

<table><tr><td align="right">

**Hello**,

_world_.
</td></tr>
<tr><td>

1. hello
2. world and a very long line.
</td></tr></table>

github rendering test:

Note: Since the output might be different than the current conversion, this change should be considered breaking.

if an author accidentally puts and image into a heading, it is automatically moved below the heading.
eg:

- heading
   - Hello
   - <img>

becomes:

# Hello
![](img)

but when the image is the first element it should go above the heading:

- heading
   - <img>
   - Hello

becomes:

![](img)
# Hello

└─1 paragraph[2]
    ├─0 link[3]
    │   │ url: "https://main--healthy-kp--hlxsites.hlx.page/northern-california/health-wellness/cancer-care/"
    │   ├─0 text "Cancer Care"
    │   ├─1 break "\n"
    │   └─2 break "\n"

• should move breaks after link.
• non leading/trailing breaks should be converted to spaces, as they can't be represented in markdown.

There is an error with this repository's Renovate configuration that needs to be fixed. As a precaution, Renovate will stop PRs until it is resolved.

Error type: Failed to decrypt field npmToken. Please re-encrypt and try again.

This issue lists Renovate updates and detected dependencies. Read the Dependency Dashboard docs to learn more.

This repository currently has no open or pending branches.

Detected dependencies

• Check this box to trigger a request for Renovate to run again on this repository

since the gridtables were moved to https://github.com/adobe/micromark-extension-gridtables their support should be removed here

Relates to https://github.com/adobe/helix-word2md/issues/703

When an MDAST contains table cells with nodes of type html, conversion of those table to HTML cause issues. Reason is the following line:

The inner function md2hast returns null because it considers nodes of type html dangerous, so the subsequent invocation of hast2html fails.

micromark uses conditional package exports:
https://github.com/micromark/micromark/blob/9a3a2dd28b996049fe7de46d6e6f905d20bf5caf/packages/micromark/package.json#L56-L57

those are imported, depending on the --conditions argument:
https://nodejs.org/docs/latest-v14.x/api/packages.html#packages_resolving_user_conditions

the frontmatter tests fail with --conditions=development

Research if https://github.com/zestedesavoir/zmarkdown/tree/master/packages/remark-grid-tables can be used for grid tables in helix

also see: https://pandoc.org/MANUAL.html#extension-grid_tables

GridTables look like this:

+-------------------+------+
| Table Headings    | Here |
+--------+----------+------+
| Sub    | Headings | Too  |
+========+=================+
| cell   | column spanning |
| spans  +---------:+------+
| rows   |   normal | cell |
+---v----+:---------------:+
|        | cells can be    |
|        | *formatted*     |
|        | **paragraphs**  |
|        | ```             |
| multi  | and contain     |
| line   | blocks          |
| cells  | ```             |
+========+=========<+======+
| footer |    cells |      |
+--------+----------+------+

• the top of a cell must be indicated by +- followed by some - or + and finished by -+.
• if the table contains a footer but no header, the top row should use = as grid line.
• col spans are indicated by missing column (|) delimiters
• row spans are indicated by missing row (-) delimiters
• cells can be left, center, right, or justify aligned; indicated by the placement of : or ><
• cells can be top, middle, or bottom v-aligned; indicated by the placement of arrows (v ^ x)
• the header and footer sections are delimited by section delimiters (=).
• if no section delimiters are present, all cells are placed in the table body.
• if only 1 section delimiter is present, it delimits header from body.
• the content in cells can be a full Markdown document again. note, that the cell boundaries (|)
  need to exactly match with the column markers (+) in the row delimiters, if the cell content
  contains |, otherwise the correct layout of the table can't be guaranteed.

Layout

The table layout tries to keep the table within a certain width (default 120). For example,
if the table has 3 columns, each column will be max 40 characters wide. If all text in a column
is smaller, it will shrink the columns. However, cells have a minimum width (default 10) when
text needs to be broken. If the cell contents need more space, e.g. with a nested table or
code block, it will grow accordingly.

Align

Horizontal align is indicated by placing markers at the grid line above the cell:

Justify     Center     Left       Right
+>-----<+  +:-----:+  +:------+  +------:+
| A b C |  |  ABC  |  | ABC   |  |   ABC |
+-------+  +-------+  +-------+  +-------+

Vertical align is indicated by placing markers at the center of the grid line above the cell:

Top        Middle     Bottom
+---^---+  +---x---+  +---v---+
| Larum |  |       |  |       |
| Ipsum |  | Larum |  |       |
|       |  | Ipsum |  | Larum |
|       |  |       |  | Ipsum |
+-------+  +-------+  +-------+

Syntax

gridTable := tbd;

Note: the top of a cell must be indicated by +- followed by some - or + and finished by -+.
So, this is not a correct table:

+--+
|a |
+--+

But, this is a correct table:

+---+
| a |
+---+

MDAST Syntax tree

The following interfaces are added to [mdast][] by this utility.

Nodes

GridTable

interface GridTable <: Parent {
  type: "gridTable"
  children: [GridTableHeader|GridTableBody|GridTableFooter]
}

GridTableHeader

interface GridTableHeader <: Parent {
  type: "gtHead"
  children: [GridTableRow]
}

GridTableBody

interface GridTableBody <: Parent {
  type: "gtBody"
  children: [GridTableRow]
}

GridTableFoot

interface GridTableFooter <: Parent {
  type: "gtFoot"
  children: [GridTableRow]
}

GridTableRow

interface GridTableRow <: Parent {
  type: "gtRow"
  children: [GridTableCell]
}

GridTableCell

interface GridTableCell <: Parent {
  type: "gtCell"
  colSpan: number >= 1
  rowSpan: number >= 1
  align: alignType
  valign: valignType
  children: [MdastContent]
}

GridTableCell ([Parent][dfn-parent]) represents a header cell in a
[GridTable][dfn-table], if its parent is a [gridTableHead][term-head], or a data
cell otherwise.

GridTableCell can be used where [gridTableRow][dfn-row-content] content is expected.
Its content model is [mdast][dfn-phrasing-content] content, allowing full mdast documents.

Enumeration

alignType

enum alignType {
  "left" | "right" | "center" | "justify" | null
}

valignType

enum alignType {
  "top" | "bottom" | "middle" | null
}