You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
I investigated Markdown in mkdocs-material vs AsciiDoc last week, and I was able to get near parity regarding industry-standard tech writing features, including include files, conditionals, advanced formatting, and variables.
Can anyone help overcome the following difficulties? Or are these issues not overcomable?
cross references: I could not find any comparable functionality to xrefs in AsciiDoc.
xrefs are great for several reasons. 2 that jump to mind are:
They resolve automatically, so you can put xrefs in snippets and it doesn't matter where you put the snippet in the dir tree hierarchy, the xref resolves correctly.
The title of the target pages automatically populates the xref text if you leave it blank, which can be great for avoiding inaccurate link text if you update the target page's title.
How do I define and use conditions and variables? I know that I have to edit the main.py file to add variables and define conditions, so that I can later use conditional text and insert variables, but I can't find info on how to edit main.py, and I can't find info on how to implement conditional text once I've set it up in main.py, either globally or per topic.
Tables--How do format text in table cells, like bold, italics, lists...in other words normal markdown formatting?
reacted with thumbs up emoji reacted with thumbs down emoji reacted with laugh emoji reacted with hooray emoji reacted with confused emoji reacted with heart emoji reacted with rocket emoji reacted with eyes emoji
Uh oh!
There was an error while loading. Please reload this page.
Uh oh!
There was an error while loading. Please reload this page.
-
I investigated Markdown in mkdocs-material vs AsciiDoc last week, and I was able to get near parity regarding industry-standard tech writing features, including include files, conditionals, advanced formatting, and variables.
Can anyone help overcome the following difficulties? Or are these issues not overcomable?
xrefs are great for several reasons. 2 that jump to mind are:
Beta Was this translation helpful? Give feedback.
All reactions