It is my understanding that that is not supported by GFM. While the spec does not specifically mention multiple line cells, there are no examples with any cells that contain multiple lines. The Tables section of the GFM Spec plainly states:īlock-level elements cannot be inserted in a table.Īnd gives this simple example: | foo | bar | Regardless, the GFM Spec is the controlling spec for any Markdown rendered on. However, as the documentation clearly states that "GitHub-flavored extensions" are supported, that would indicate to me that the GFM Spec would be a good reference. Whether VSTS actually uses a CommonMark/GFM implementation or a close approximation is unclear from the documentation. Note that GitHub adopted the current spec on March 14, 2017, so any information older that that may not be relevant for the current implementation. Therefore, to say that an implementation supports GFM is to say that it supports CommonMark with extensions. GitHub-Flavored Markdown (GFM) is an extension of CommonMark (which adds features to CommonMark such as tables), with its own spec. Like this: | Fruit | Price | Advantages |īelow is an explanation of each tool with an analysis of that tool's documentation: GitHubĬommonMark is a Markdown variant with a strict spec. In short, each row must be on one line and should use to indicate a line break. The issue is most likely Microsoft disabling html.Ī solution thus waits on a reply to suggestion: | Bananas | first linenext line | first linenext line | The markdown-it library does support the usage suggested by | Fruit | Price | Advantages | I would like to ask the question of Microsoft themselves but their ask a question link goes straight to stack overflow. Its unclear which version VSTS actually uses under the hood. I've raised an issue there for clarification (or enhancement). I found the link to markdown-it and added it above. I would be happy to use html readmes instead if that was permitted. +-+-+-+īut neither this nor embedded html seem to work in VSTS. My current stumbling block is multi-row cells. Pandoc -f docbook -t markdown_github -i "$OUTPUT".xml -o "$OUTPUT" (Asciidoctor converts to docbook which pandoc can then parse) asciidoctor -b docbook -v -o "$OUTPUT".xml "$INPUT" & I've been using a combination of asciidoctor and pandoc to convert files but nothing gets it quite right. Specification which you can read about in this update.
Markdown tables code#
Q: Does VS Code support GitHub Flavored Markdown?Ī: No, VS Code targets the CommonMark Markdown specification using the I found another page saying they use commonmark via the markdown-it library.
This page says that github flavoured markdown can be used However, it is unclear what flavour of markdown is actually supported
The company now has projects on VSTS which does not support asciidoc so I need to use markdown instead. I have previously used asciidoc for readme files on github as it is both richer and less ambiguous. How can you add tables with multi-row cells to markdown in Microsoft VSTS?
0 kommentar(er)
