Then just Google “git cms” for a list of different options on that front. SSGs in other languages: Hugo(Go), Zola(Rust), Jekyll(Ruby) Docusaurus: React SSG designed specifically for documentation AstroJS: SSG that allows you to use any JS framework you want. ![]() The “markdown is not very good for tables” issue has been solved long ago with either plugins such as “advanced table plugin” for Obsidian or apps like the £10 one off payment app “TableFlip” by Brett Terpstra. ![]() It makes documentation quick and easy to write which means devs are more likely to actually do it. Keep it simple and keep it non proprietary wherever possible otherwise you are always running the risk of being held over a barrel. It got a huge amount of upvotes but also got quite a few nay sayers some of whom said something along the lines of “businesses don’t care about portability” to which I said “they absolutely will if one day atlassian hikes the prices, gets acquired or the product is discontinued”. And then to have their godawful cloud Jira meltdown happen shortly afterwards and have them not adjust any license terms in apology for it was the topper on the cake.Ī few months ago there was a big thread on documentation and I said I was convinced that markdown files and an SSG was the way to go, with some kind of web CMS that auto gits for the non technical people. I get why they did it and even kind of understand doing it, but the whole thing was handled in the most user-unfriendly, tone-deaf way possible. I’ll never not be upset with Atlassian over that mess. ![]() I’m glad I never had to make that call, because killing our self-hosted Confluence was going to suck badly. And we preferred something that could at least display Office-doc and PDF content transparently, although that was looser. We needed something with tight integration with Jira, as we frequently used the ability to display Jira issue reports and auto-create wiki pages. We needed something that non-tech people could equally contribute to and maintain (so git with static pages was out, as were the many wikis that required writing content in Markdown without a WYSIWYG UI). None of them, however, quite fit with our use cases. The top 3 contenders at the time were Xwiki ( ), Bookstack ( ), and BlueSpice ( ) based on Mediawiki. The below example explains about alignment.I did a bunch of research on this before leaving my last job, as we were in the same lousy spot. Header and cell data can be aligned to the left or right of columns in a table Output is Header1 Header2 Header3 bold style code block italic |escape pipe `backtick data13 Align cell data using the colon symbol Table data can include |Header1 |Header2 | Header3| If cell content wants to include pipe or backtick symbols, symbols need to be escaped. Table cell data can include all other markdown content styles like links, bold table’s data like header and row can contain simple text or markdown content Markdown table content format styles.pipe symbols on row start and end are optional.Each column of row data is separated by the pipe symbol.Pipes(|) symbol is optional, but used for readability.A minimum of 3 hyphens(dash symbol)under each header name is required, can declare more than three dashes.tables without headers are not supported in core specification. ![]() Output generated in the browser is Header1 Header2 Header3 data1 data2 data3 data11 data12 data13 Here is a table syntax |Header1 |Header2 | Header3| Headers are created using a minimum of three hyphens, Columns of data or headers can be separated by the pipe symbol. It can be created using the Pipe operator ! and dash symbols. Tables containers rows and columns and headers. The table contains the following components Initially, tables were not supported in core markdown specification, Once extended vendors like GitHub formatted markdown supported tables, the Markdown team added inbuilt support. Tables are used to represent the data in a multidimensional format.
0 Comments
Leave a Reply. |
AuthorWrite something about yourself. No need to be fancy, just an overview. ArchivesCategories |