Main Content

Publish and ShareMATLABCode

MATLAB®provides options for presenting your code to others. You can publish your MATLAB Code files (.m) to create formatted documents or you can create and share live scripts and live functions in the Live Editor.

Create and Share Live Scripts in the Live Editor

The easiest way to create cohesive, sharable documents that include executable MATLAB code, embedded output, and formatted text is to use the Live Editor. Supported output formats include: MLX, PDF,Microsoft®Word, HTML, and LaTeX. For details, seeCreate Live Scripts in the Live Editor.

Live script with a formatted title, text, code, and the resulting output figure

PublishMATLABCode Files (.m)

To create shareable documents using your MATLAB Code files (.m), you canpublishthe files. Publishing a MATLAB Code file creates a formatted document that includes your code, comments, and output. Common reasons to publish code are to share the documents with others for teaching or demonstration, or to generate readable, external documentation of your code.

This code demonstrates the Fourier series expansion for a square wave.

MATLAB Code with Markup

D发表ocument

Code with green comments that include markup for a title, subheadings, and an equation

Published document that includes a title, subheadings, and formatted equations, as well as code and the resulting output

To publish your code:

  1. Create a MATLAB script or function. Divide the code into steps or sections by inserting two percent signs (%%) at the beginning of each section.

  2. Document the code by adding explanatory comments at the beginning of the file and within each section.

    Within the comments at the top of each section, you can add markup that enhances the readability of the output. For example, the code in the preceding table includes the following markup.

    Titles

    %% Square Waves from Sine Waves

    %% Add an Odd Harmonic and Plot It

    %% Note About Gibbs Phenomenon

    Variable name in italics

    % As _k_ increases, ...

    LaTeX equation

    % $$ y = y + \frac{sin(k*t)}{k} $$

    Note

    When you have a file containing text that has characters in a different encoding than that of your platform, when you save or publish your file, MATLAB displays those characters as garbled text.

  3. Publish the code. On thePublishtab, clickPublish.

    By default, MATLAB creates a subfolder namedhtml, which contains an HTML file and files for each graphic that your code creates. The HTML file includes the code, formatted comments, and output. Alternatively, you can publish to other formats, such as PDF files orMicrosoft PowerPoint®presentations. For more information on publishing to other formats, seeSpecify Output File.

    InMATLAB Online™, to allow MATLAB to open output windows automatically when publishing, enable pop-up windows in your Web browser.

After publishing the code, you can share the folder containing the published files. For more information, seeShare Folders in MATLAB.

The sample code that appears in the previous figure is part of the installed documentation. You can view the code in the Editor by running this command:

edit(fullfile(matlabroot,'help','techdoc',“matlab_env”,...'examples','fourier_demo2.m'))

Add Help and Create Documentation

You can add help to your code by inserting comments at the start of a MATLAB code file. MATLAB displays the help comments when you typehelpfile_namein the Command Window. For more information, see为程序添加帮助.

You also can create your own MATLAB documentation topics for viewing from the MATLAB Help browser or the web. For more information, seeDisplay Custom Documentation

See Also

Related Topics

External Websites