Выход DocFX в Markdown

Question

Глядя на поток, DocFX, похоже, создает файлы .md, а затем конвертирует его в html при создании документации.

Есть ли способ сделать вывод DocFX в .md-файлы вместо html?

Answer 1

Вы должны переместить файлы .md с content в resource в docfx.json.

В качестве примера возьмем фрагмент docfx.json. Все файлы .md в articles будут преобразованы в .html на выходе.

... 
"build": { 
    "content": [ 
    { 
     "files": ["articles/**.md"] 
    } 
    ] 
} 
... 

Если вы надеетесь articles/sample.md остается непрореагировавший, вы можете изменить docfx.json, как показано ниже:

... 
"build": { 
    "content": [ 
    { 
     "files": ["articles/**.md"], 
     "exclude": ["articles/sample.md"] 
    } 
    ] 
    "resource": [ 
    { 
     "files": ["articles/sample.md"] 
    } 
    ] 
} 
... 

Более подробную информацию можно найти на DocFX User Manual.