Your achievements

Level 1

0% to

Level 2

Tip /
Sign in

Sign in to Community

to gain points, level up, and earn exciting badges like the new
BedrockMission!

Learn More

View all

Sign in to view all badges

Would like the ability to import and export MD content

Avatar

Avatar
Validate 1
Level 2
robertk30941538
Level 2

Likes

5 likes

Total Posts

12 posts

Correct Reply

0 solutions
Top badges earned
Validate 1
Ignite 1
Give Back 5
Give Back 3
Give Back
View profile

Avatar
Validate 1
Level 2
robertk30941538
Level 2

Likes

5 likes

Total Posts

12 posts

Correct Reply

0 solutions
Top badges earned
Validate 1
Ignite 1
Give Back 5
Give Back 3
Give Back
View profile
robertk30941538
Level 2

15-03-2021

We would like to have a single location (AEM) for our content. We want to author in DITA and then export/convert the DITA to markdown for use in our GitHub documentation. Also, we would like to import some of our markdown docs into AEM and convert them to DITA so that we no longer need to manage the content in two source systems and use two different markup languages.

GIT markdown MD

Replies

Avatar

Avatar
Ignite 3
Employee
Kiran_Mohan
Employee

Likes

8 likes

Total Posts

10 posts

Correct Reply

0 solutions
Top badges earned
Ignite 3
Boost 5
Give Back 3
Boost 3
Boost 1
View profile

Avatar
Ignite 3
Employee
Kiran_Mohan
Employee

Likes

8 likes

Total Posts

10 posts

Correct Reply

0 solutions
Top badges earned
Ignite 3
Boost 5
Give Back 3
Boost 3
Boost 1
View profile
Kiran_Mohan
Employee

16-03-2021

Hi,

XML documentation uses DITA-OT internally to generate the different output. DITA-OT allows the markdown files generation from source dita content and it also lets the author use the raw markdown files for publishing. Please refer below for more details:

  1. Generating Markdown files from the source DITA files
    1. DITA-OT provides three variety of markdown files
  1.       Standard Markdown
  2.       GitHub-Flavored Markdown Files
  •       GitHub-Flavored Markdown Files with summary.md file

More details can be referred here - https://www.dita-ot.org/dev/topics/dita2markdown.html

 

All the above markdown files types are supported by DITA-OT and can be generated from the XML Documentation Solution by using the relevant transtype. Example – To generate GitHub-Flavored Markdown files, use the markdown_github transtype on the output-preset.

 

Kiran_Mohan_0-1615898211493.png

 

 

  1. Using Markdown down files for generating output
    1. There is a provision to use the markdown files with the maps and generate the PDF/pre-processed DITA/HTML5 output. There would two things required:

Then you can generate any supported output format e.g. PDF or dita (for normalized dita)

 

If you need more details OR wanted to discuss your specific use case then please reach out to TechCommSales@adobe.com for a quick demo.

 

Thanks & Regards,

Kiran Mohan

Avatar

Avatar
Validate 1
Level 2
robertk30941538
Level 2

Likes

5 likes

Total Posts

12 posts

Correct Reply

0 solutions
Top badges earned
Validate 1
Ignite 1
Give Back 5
Give Back 3
Give Back
View profile

Avatar
Validate 1
Level 2
robertk30941538
Level 2

Likes

5 likes

Total Posts

12 posts

Correct Reply

0 solutions
Top badges earned
Validate 1
Ignite 1
Give Back 5
Give Back 3
Give Back
View profile
robertk30941538
Level 2

16-03-2021

Thanks Kiran. The problem is when I upload an MD file to AEM, it is not recognized. AEM does not seem to understand what type of file it is.

Avatar

Avatar
Ignite 3
Employee
Kiran_Mohan
Employee

Likes

8 likes

Total Posts

10 posts

Correct Reply

0 solutions
Top badges earned
Ignite 3
Boost 5
Give Back 3
Boost 3
Boost 1
View profile

Avatar
Ignite 3
Employee
Kiran_Mohan
Employee

Likes

8 likes

Total Posts

10 posts

Correct Reply

0 solutions
Top badges earned
Ignite 3
Boost 5
Give Back 3
Boost 3
Boost 1
View profile
Kiran_Mohan
Employee

16-03-2021

That is okay. But you should still be able to add that to your map.( Additional information - The authoring of the markdown file in the AEM system is in our roadmap)

 

If you drag/drop the markdown file into map from xml editor then it will automatically add format attribute also. Do let me know if you want a short demonstration of this.

 

Thanks & Regards,

Kiran Mohan